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简介 
译文 同时 以 GitHub Issue 的 形式 发 布 ， 点 此 阅读 。 


版 权 协 议 


除 注 明 外 ， 所 有 文章 均 采 用 Creative Commons BY-NC-ND 3.0 (自由 转载 -保持 署名 - 非 商用 - 
FEAT) 协议 发 布 。 


这 意味 着 你 可 以 在 非 商业 的 前 提 下 免费 转载 ， 但 同时 你 必须 : 


e 保持 文章 原文 ， 不 作 修改 。 
e 明确 署名 ， 即 至 少 注 明 作者 :cundi 字样 以 及 文章 的 原始 链接 。 


如 需 商业 合作 ， 请 直接 联系 作者 。 


如 果 你 认为 译文 对 你 所 有 帮助 ， 而 且 希 望 看 到 更 多 ， 可 
以 考虑 小 额 捐助 。 


Web.Development.with.Django.Cookbook 


中 文 名 : 《Django 网 站 开发 Cookbook》，14 年 10 月 份 的 新 书 ， 可 不 是 09 年 的 那个 Django 
book 

原版 英文 : https://www.packtpub.com/web-development/web-development-django-cookbook 
作者 : Aidas Bendoraitis 

日 期 : October 2014 

特色 : Over 70 practical recipes to create multilingual, responsive, and scalable websites 
with Django 

级 别 : Cookbook 

页 数 : Paperback 294 pages 


该 书 的 第 二 版 会 在 2016 年 二 月 份 上 市 ， 具 体 情 况 看 Packpub 出 版 社 的 连接 : 
https://www.packtpub.com/web-development/web-development-django-cookbook- 
second-edition ， 既 然 都 出 第 二 版 了 还 是 等 新 版 出 来 再 更 新 吧 


第 五 章 定制 模板 过 滤器 和 标签 


本 章 ， 我 们 会 学 习 以 下 内 容 : 


遵循 模板 过 滤器 和 标签 的 约定 

e 创建 一 个 模板 过 滤器 显示 已 经 过 去 的 天 数 

e 创建 一 个 模板 过 滤器 提取 第 一 个 媒体 对 象 

。 创建 一 个 模板 过 滤器 使 URL 可 读 

° idc dul a a aed 
e 创建 一 个 模板 标签 为 模板 解析 内 容 

e 创建 一 个 模板 标签 修改 request 查 询 参 数 





简介 


众所周知 ，Django 有 一 个 非常 庞大 的 模板 系统 ， 拥 有 模板 继承 ， 改 变 具 体 值 的 过 滤器 ， 以 及 
dic pads 。 此 外 ，Django 允 许 你 在 应 用 中 添加 你 自己 的 模板 过 滤器 和 标签 。 定 制 

虑 器 或 者 标签 应 该 位 于 应 用 中 和 下 的 标签 库 文 件 。 你 的 模板 库 在 任何 模板 中 使 
à (X load %} 模板 标签 载 入 。 在 这 一 章 ， 我 们 会 创建 多 个 实用 的 过 滤器 和 对 模板 编辑 带 来 更 
多 控制 的 标签 。 


芝 循 模板 过 滤器 和 标签 的 规定 
如 果 你 么 有 坚持 按 指 南 来 做 ， 那 么 定义 模板 过 滤器 和 标签 会 变 得 极其 混乱 不 堪 。 模 板 过 滤器 


和 标签 应 该 尽 可 能 地 服务 于 模板 。 它 们 应 该 同时 具有 方便 性 和 灵活 性 。 在 这 个 做 法 中 ， 我 们 
会 看 到 用 来 增强 Django 模 板 系统 功能 的 规定 。 


如 何 做 
扩展 Django 模 板 系 统 时 遵循 以 下 规定 : 


1. SEMA? 上下文 处 理 器 ， 或 者 模型 方法 中 ， 页 面 更 适合 逻辑 时 ， 不 要 创建 或 者 使 用 定制 模板 过 滤器 、 标 签 。 你 的 页 


[jp uus] 





2. 使 用 _tags 后 级 命名 模板 标签 库 。 当 你 的 app 命 名 不 同 于 模板 标签 库 时 ， 你 可 以 避免 模糊 的 包 导 入 问题 。 


3. 例如 ， 通 过 使 用 如 下 注释 ， 在 最 新 创建 的 库 中 ， 从 标签 中 分 离 过 滤器 : 


4 -*- coding: UTF-8 -*- 

from django import template 
register - template.Library() 
### FILTERS ### 

# .. your filters go here .. 


#H## TAGS ### 
. your tags go here.. 


4. 通过 纳入 以 下 格式 ， 创 建 模板 标签 也 可 以 被 轻松 记 住 : 


for [app name.model name]: 使 用 该 格式 以 使 用 指定 的 模型 
using [template name]: 使 用 该 格式 将 一 个 模板 的 模板 标签 输出 
limit [count]: 使 用 该 格式 将 结果 限制 为 一 个 指定 的 数量 


as [context variable]: 使 用 该 结构 可 以 将 结构 保存 到 一 个 在 之 后 多 次 使 用 的 上 下 文 变量 


5. 要 尽量 避免 在 模板 标签 中 按 位 置地 定义 多 个 值 ， 除 非 它 们 都 是 不 解 自明 的 。 和 否则 ， 这 会 有 可 能 使 开发 者 迷惑 。 


6. 尽 可 能 的 使 用 更 多 的 可 理解 的 参数 。 没 有 引号 的 字符 串 应 该 当 作 需要 解析 的 上 下 文 变量 或 者 可 以 提醒 你 关于 模板 标签 








参见 


创建 一 个 显示 已 经 过 去 天 数 的 模板 过 滤器 


创建 一 个 提取 第 一 个 媒体 对 象 的 模板 过 滤器 


e 


创建 一 个 人 类 可 理解 的 URL 的 模板 过 滤器 
创建 一 个 接纳 已 经 存在 的 模板 的 模板 标签 
创建 一 个 载 入 模板 中 的 Queryset 的 模板 标签 


创建 一 个 可 以 把 内 容 解 析 为 模板 的 模板 标签 





创建 一 个 修改 request 查 询 参 数 的 模板 标签 


创建 一 个 显示 已 经 过 去 天 数 的 模板 过 滤器 


不 是 所 有 的 人 都 需要 持续 追踪 日 期 ， 当 论 及 前 沿 信息 的 创建 和 修改 时 ， 对 于 我 们 多 数 人 来 
说 ， 读 取 时 间 的 差异 会 更 加 人 便利， 例如， 三 天 之 前 发 布 的 博客 文章 ， 当 日 debi 
昨日 最 后 登录 的 用 户 。 此 做 法 中 ， 我 们 会 创建 一 个 称 为 days since 的 模板 过 滤器 ， 它 会 转换 


到 人 类 可 理解 的 时 间 差 。 


准备 开始 


如 果 完 成 操作 ， 可 以 在 设置 中 的 INSTALLED_APPS 下 创建 utils 应 用 。 然 后 ， 在 这 个 应 用 中 创 
建 命名 为 templatetags Python 包 (Python 包 是 一 个 拥有 空 的 _init .py 文件 ) ° 


怎么 做 
用 下 面 的 内 容 创 建 一 个 utility tags.py 文件 : 


#utils/templatetags/utility_tags.py 
# -*- coding: UTF-8 -*- 


from datetime import datetime 


from django import template 

from django.utils.translation import ugettext_lazy as _ 
from django.utils.timezone import now as tz_now 
register = template.Library() 


### FILTERS ### 


@register.filter 
def days_since(value): 
""" 返回 天 和 值 之 间 的 天 数 .""" 


today = tz now().date() 
if isinstance(value, datetime.datetime): 
value - value.date() 
diff - today - value 
if diff.days » 1: 
return _("%s days ago") % diff.days 
elif diff.days == 1: 
return _("yesterday") 
elif diff.days == 
return _("today") 
else: 
# Date is in the future; return formatted date. 
return value.strftime("%B %d, %Y") 


工作 原理 
如 果 像 下 边 这 样 在 模板 中 使 用 这 个 过 滤器 ， 它 会 返回 yesterday 或 者 5 days ago 这 样 的 内 容 : 


“{% load utility tags %} 
{{ object.created|days since jj 
You can apply this filter to the values of the date and datetime types. 


你 可 以 应 用 这 个 过 滤器 到 date 8348 * fe datetime 的 类 型 。 


每 个 标签 库 都 有 一 个 注册 器 ， 它 是 收集 过 滤器 和 标签 的 地 方 。Django 过 滤器 使 

用 register.filter 装饰 器 所 注册 的 函数 。 上 默认， 模板 系统 中 的 过 滤器 命名 为 相同 名 称 的 遂 
数 ， 或 者 其 他 的 可 调用 对 象 。 如 果 你 想 的 话 ， 你 可 以 通过 传递 name 到 装饰 器 来 为 过 滤器 设置 
不 同 的 名 称 : 


Qregister.filter(name-"humanized days since") 
def days since(value): 


过 滤器 本 身 意 思 是 非常 显而易见 的 。 首 先 ， 当 前 日 期 被 读 取 。 如 果 给 出 的 过 滤器 值 
是 datetime 类 型 ， 那 么 日 期 就 会 被 提取 。 然 后， 计算 今天 和 提取 值 之 间 的 差异 。 视 天 数 而 
定 ， 返 回 不 同 的 字符 囊 结果 


还 有 更 多 


过 滤器 可 以 很 容易 地 扩展 以 显示 时 间 的 不 同 ， 比 如 just now ，7 minutes ago ， 或 
者 3 hours ago ? 只 要 操作 datetime 值 便 是 ， 而 不 是 操作 date 值 。 


参阅 


创建 一 个 提取 第 一 个 媒体 对 象 的 模板 过 洪 


s 


aa 
E 


创建 一 个 人 类 可 理解 的 URL 的 模板 过 滤器 


5E% AL JE 2 
创建 一 个 提取 第 一 个 媒体 对 象 的 模板 过 滤器 
想象 一 下 ， 你 正在 开发 一 个 博客 概述 页 面 ， 对 于 每 篇 文章 ， 你 想 在 这 个 页 面 中 显示 内 容 中 的 
图 片 ， 音 乐 或 者 视频 。 这 样 的 情况 下 ， 你 需要 从 文章 的 HTML 内 容 中 提 
取 <img> * «object» ， 和 «embed» 标签 。 这 个 做 法 中 ， 我 们 会 见 到 在 get first media 中 如 
何 使 用 正则 表达 式 完成 目标 。 


准备 开始 吧 


我 们 从 位 于 设置 中 的 INSTALLED_APPS 的 utils 应 用 开始 ， 并 将 templatetags 包 置 于 该 应 用 内 
部 。 


如 何 做 


在 utility tags.py 文件 中 ， 添 加 以 下 内 容 : 


#utils/templatetags/utility_tags.py 

# -*- coding: UTF-8 -*- 

import re 

from django import template 

from django.utils.safestring import mark_safe 
register = template.Library() 


### FILTERS ### 


media file regex = re.compile(r"«object .+?</object>|" 
r"«(img|embed) [^2]*2") ) 


Qregister.filter 
def get first media(content): 
""" dREhtmln ET$—4B8B:X4flashxd4F """ 
m = media file regex.search(content) 
media tag = "" 
if m: 
media tag - m.group() 
return mark safe(media tag) 


工作 原理 


当 数 据 中 的 HTML 内 容 有 效 时 ， 把 下 面 的 代码 写 到 模板 里 ， 它 会 从 对 象 的 内 容 字段 重新 取 
E] «object» ， <img> 或 者 <embed> 标签 ， 或 者 一 个 因 媒 体 不 存在 而 出 现 的 空 字符 串 : 


{% load utility tags %} 
{{ object.content|get first media }} 


首先 ， 我 们 把 编译 过 的 正则 表达 式 定义 为 media file regex ， 然 后 ， 在 过 滤器 中 ， 我 们 执行 

正则 表达 式 模 式 的 搜索 。 黑 认 ， 结 果 会 把 出 现 的 < > > 和 & 转 义 为 条 目 gt; ^ &gt; ， 以 

A gamp; 。 我 们 使 用 mark safe 函数 把 结果 标记 为 安全 的 HTML， 为 在 模板 中 不 实用 转 义 显示 
做 好 准备 。 


还 有 更 多 


你 可 以 非常 容易 地 扩展 这 个 过 滤器 ， 它 也 可 以 提取 <iframe> 标签 (最 近 它 们 被 Vimeo 和 
Youtube H AA ALIA) 或 者 HTML5 的 «audio» 和 «video» 标签 ， 可 以 像 这 样 修 改正 则 表达 
Ñ: 


media file regex = re.compile(r"<iframe .+?</iframe>|" 
r"«audio .+?</ audio>|<video .+?</video>|" 
r"«object .+?</object>|<(img|embed) [4>]+>") ” 


创建 一 个 显示 已 经 过 去 天 数 的 模板 过 滤器 


创建 一 个 人 类 可 理解 的 URL 的 模板 过 滤器 


目录 预览 


第 一 章 ， 从 Django1.6 开 始 


指导 你 通过 必要 的 基本 配置 以 新 建 任意 Django 项 目 。 本 章 和 覆盖 内 容 有 ， 虚 拟 环境 ， 会 话 控 
制 ， 以 及 项 目 设 置 。 


第 二 章 ， 数 据 库 结构 


教会 你 如 何 写 可 重复 使 用 的 代码 片段 并 用 在 模型 中 。 当 你 创建 一 个 新 的 app 时 ， 要 做 的 第 一 件 
就 是 定义 模型 。 你 也 告知 如 何 使 用 South 迁 移 管理 数据 库 表 变 更 。 


第 三 草 ， 表 单 和 视图 


向 你 演示 使 用 一 些 模式 为 数据 创建 视图 和 表单 


第 四 章 ， 模 板 和 JavaScript 
向 你 演 ye eo rar 的 实际 例子 。 我 们 把 模板 和 JavaScript 放 在 一 


因为 ， 总 是 通过 泻 染 模板 将 内 容 展现 给 用 户 ， 在 现代 的 网 站 中 ，JavaScript 对 于 更 丰富 的 用 户 
体验 也 是 必要 的 。 


第 五 章 ， 自 定义 模板 过 滤器 和 标签 


本 章 向 你 演示 如 如 何 创建 并 使 用 模板 过 滤器 和 标签 ， 因 为 ，Django 的 模板 系统 包含 内 容 极 
广 ， 因 此 可 以 有 更 多 的 东西 对 不 同 的 应 用 场景 来 添加 。 


大 大 o > 


第 六 草 ， 模 型 管理 


本 章 ， 将 指导 你 通过 使 用 自 定义 的 功能 来 扩展 默认 admin ， 


第 七 章 ，Django CMS 


第 九 草 ， 数 据 的 导入 和 导出 


第 十 章 ， 附 加 功能 


1. 


Getting Started with Django 1.8 


Introduction 
Working with a virtual environment 

o Getting ready 

o How to do it... 

o How it works... 

o See also 
Creating a project file structure 

o Getting ready 

o How to do it... 

o How it works... 

o See also 
Handling project dependencies with pip — Getting ready — How to do it... — How it 
works... — There's more... — See also — Making your code compatible with both 
Python 2.7 and Python 3 — Getting ready — How to do it... — How it works... — 
Including external dependencies in your project — Getting ready — How to do it... — 
How it works... — See also — Configuring settings for development, testing, staging, 
and production environments — Getting ready — How to do it... — How it works... — 
See also — Defining relative paths in the settings — Getting ready — How to do it... — 
How it works... — See also — Creating and including local settings — Getting ready — 
How to do it... —How it works... — See also — Setting up STATIC URL dynamically for 
Subversion users — Getting ready — How to do it... — How it works... — See also — 
Setting up STATIC. URL dynamically for Git users — Getting ready — How to do it... 一 
How it works... — See also — Setting UTF-8 as the default encoding for MySQL 
configuration — Getting ready — How to do it... —How it works... — Setting the 
Subversion ignore property — Getting ready — How to do it... — How it works... — See 
also — Creating the Git ignore file — Getting ready — How to do it... — How it works... 
— See also — Deleting Python-compiled files — Getting ready — How to do it... — 
How it works... — See also — Respecting the import order in Python files — Getting 
ready — How to do it... — How it works... — There's more... — See also — Creating 
app configuration — Getting ready — How to do it... — How it works... — There is 


more... — See also 


e Defining overwritable app settings — Getting ready — How to do it... — How it works... 


2. 


Database Structure 


Introduction Using model mixins Getting ready How to do it... How it works... There's 


more... See also Creating a model mixin with URL-related methods Getting ready How to do 


it... How it works... See also Creating a model mixin to handle creation and modification 


dates Getting ready How to do it... How it works... See also Creating a model mixin to take 


care of meta tags Getting ready How to do it... How it works... See also Creating a model 


mixin to handle generic relations Getting ready How to do it... How it works... See also 


Handling multilingual fields Getting ready How to do it... How it works... Using migrations 


Getting ready How to do it... How it works... See also Switching from South migrations to 


Django migrations Getting ready How to do it... How it works... See also Changing a foreign 


key to the many-to-many field Getting ready How to do it... How it works... See also 


1. 


Forms and Views Introduction Passing HttpRequest to the form Getting ready How to 
do it... How it works... See also Utilizing the save method of the form Getting ready 
How to do it... How it works... See also Uploading images Getting ready How to do it... 
How it works... There's more See also Creating a form layout with django-crispy-forms 
Getting ready How to do it... How it works... There's more... See also Downloading 
authorized files Getting ready How to do it... How it works... See also Filtering object 
lists Getting ready How to do it... How it works... See also Managing paginated lists 
Getting ready How to do it... How it works... See also Composing class-based views 
Getting ready How to do it... How it works... There's more... See also Generating PDF 
documents Getting ready How to do it... How it works... See also Implementing a 
multilingual search with Haystack Getting ready How to do it... How it works... See also 
Templates and JavaScript Introduction Arranging the base.html template Getting ready 
How to do it... How it works... See also Including JavaScript settings Getting ready How 
to do it... How it works... See also Using HTML5 data attributes Getting ready How to 
do it... How it works... See also Opening object details in a modal dialog Getting ready 
How to do it... How it works... See also Implementing a continuous scroll Getting ready 
How to do it... How it works... See also Implementing the Like widget Getting ready 
How to do it... How it works... See also Uploading images by Ajax Getting ready How to 
do it... How it works... See also 

Custom Template Filters and Tags Introduction Following conventions for your own 
template filters and tags How to do it... Creating a template filter to show how many 
days have passed since a post was published Getting ready How to do it... How it 
works... There's more... See also Creating a template filter to extract the first media 
object Getting ready How to do it... How it works... There's more... See also Creating a 


template filter to humanize URLs Getting ready How to do it... How it works... See also 
Creating a template tag to include a template if it exists Getting ready How to do it... 
How it works... There's more... See also Creating a template tag to load a QuerySet in a 
template Getting ready How to do it... How it works... See also Creating a template tag 
to parse content as a template Getting ready How to do it... How it works... See also 
Creating a template tag to modify request query parameters Getting ready How to do 
it... How it works... See also 

. Model Administration Introduction Customizing columns on the change list page Getting 
ready How to do it... How it works... There's more... See also Creating admin actions 
Getting ready How to do it... How it works... See also Developing change list filters 
Getting ready How to do it... How it works... See also Customizing default admin 
settings Getting ready How to do it... How it works... There's more... See also Inserting 
a map into a change form Getting ready How to do it... How it works... See also 

. Django CMS Introduction Creating templates for Django CMS Getting ready How to do 
it... How it works... See also Structuring the page menu Getting ready How to do it... 
How it works... See also Converting an app to a CMS app Getting ready How to do it... 
How it works... See also Attaching your own navigation Getting ready How to do it... 
How it works... See also Writing your own CMS plugin Getting ready How to do it... How 
it works... See also Adding new fields to the CMS page Getting ready How to do it... 
How it works... See also 

. Hierarchical Structures Introduction Creating hierarchical categories Getting ready How 
to do it... How it works... See also Creating a category administration interface with 
django-mptt-admin Getting ready How to do it... How it works... See also Creating a 
category administration interface with django-mptt-tree-editor Getting ready How to do 
it... How it works... See also Rendering categories in a template Getting ready How to 
do it... How it works... There's more... See also Using a single selection field to choose 
a category in forms Getting ready How to do it... How it works... See also Using a 
checkbox list to choose multiple categories in forms Getting ready How to do it... How it 
works... See also 

. Data Import and Export Introduction Importing data from a local CSV file Getting ready 
How to do it... How it works... There's more... See also Importing data from a local Excel 
file Getting ready How to do it... How it works... There's more... See also Importing data 
from an external JSON file Getting ready How to do it... How it works... See also 
Importing data from an external XML file Getting ready How to do it... How it works... 
There's more... See also Creating filterable RSS feeds Getting ready How to do it... 
How it works... See also Using Tastypie to create API Getting ready How to do it... How 
it works... See also Using Django REST framework to create API Getting ready How to 
do it... How it works... See also 

. Bells and Whistles Introduction Using the Django shell Getting ready How to do it... How 
it works... See also Using database query expressions Getting ready How to do it... How 


it works... See also Monkey-patching the slugify() function for better internationalization 
support Getting ready How to do it... How it works... There's more... See also Toggling 
the Debug Toolbar Getting ready How to do it... How it works... See also Using 
ThreadLocalMiddleware Getting ready How to do it... How it works... See also Caching 
the method return value Getting ready How to do it... How it works... See also Using 
Memcached to cache Django views Getting ready How to do it... How it works... See 
also Using signals to notify administrators about new entries Getting ready How to do 
it... How it works... See also Checking for missing settings Getting ready How to do it... 
How it works... See also 

Testing and Deployment Introduction Testing pages with Selenium Getting ready How to 
do it... How it works... See also Testing views with mock Getting ready How to do it... 
How it works... See also Testing API created using Django REST framework Getting 
ready How to do it... How it works... See also Releasing a reusable Django app Getting 
ready How to do it... How it works... See also Getting detailed error reporting via e-mail 
Getting ready How to do it... How it works... See also Deploying on Apache with 

mod wsgi Getting ready How to do it... How it works... There's more... See also Setting 
up cron jobs for regular tasks Getting ready How to do it... How it works... See also 
Creating and using the Fabric deployment script Getting ready How to do it... How it 
works... There's more... See also 


第 一 章 ， 从 Django1.6 开 始 


指导 你 通过 必要 的 基本 配置 以 新 建 任意 Django 项 目 。 本 章 禾 盖 内 容 有 ， 虐 拟 环境 ， 会 话 控 


制 


~- 


以 及 项 目 设 置 。 


使 用 虚拟 环境 

创建 一 个 项 目 文件 结构 

用 pip 处 理 项 目 依赖 

在 项 目 中 包括 外 部 的 依赖 

在 settings 中 定义 相对 路 径 

为 Subersion 用 户 动态 地 配置 STATIC_URL 
为 Git 用 户 动态 地 配置 STATIC_URL 
创建 并 包括 本 地 设置 

把 UTF-8 设 置 为 MySQL 配 置 的 默认 编码 格式 
设置 Subversion 的 忽略 特性 

创建 Git 的 忽略 文件 

删除 Python 编 译文 件 

Python 文 件 中 的 导入 顺序 

定义 可 重 写 的 app 设 置 


第 二 草 ， 数 据 库 结 构 


教会 你 如 何 写 可 重复 使 用 的 代码 片段 并 用 在 模型 中 。 当 你 创建 一 个 新 的 app 时 ， 要 做 的 第 一 件 
就 是 定义 模型 。 你 也 告知 如 何 使 用 Sou 


e 使 用 模型 mixin 

e 使 用 相对 URL 方 法 创建 一 个 模型 mixin 

e 创建 一 个 模型 mixin 以 处 理 日 期 的 创建 和 修改 

e 创建 一 个 模型 mixin 以 处 理 meta 标 签 

e 创建 一 个 模型 mixin 以 处 理 通用 关系 

e 处 理 多 语言 字段 

e 使 用 South 迁 移 ( 译 者 注 : Django1.7 中 已 经 有 了 自己 迁移 模块 ， 故 内 容 将 略 去 ) 
e 使 用 South 将 一 个 外 键 改变 为 多 对 多 字段 


三 草 ， 表 单 和 视图 
向 你 演示 使 用 一 些 模式 为 数据 创建 视图 和 表单 


e 传递 HttpRequest 到 表单 

e 利用 表单 的 Save 方法 

e 使 用 django-crispy-forms 生 成 表单 布局 
e 过 滤 对 象 列 表 

。 管理 分 页 列表 

e 编写 类 视图 

e 生成 PDF 文档 


大 大 


第 四 章 ， 模 板 和 JavaScript 


向 你 演 ote ea eras 的 实际 例子 。 我 们 把 模板 和 JavaScript 放 在 一 
因为 ， 总 是 通过 泻 染 模板 将 内 容 展 现 给 用 户 ， 在 现代 的 网 站 中 ，JavaScript 对 于 更 丰富 的 用 户 
体验 也 是 必要 的 B 


e 整理 base.html 模 板 

e 包含 JavaScript 设 置 
e 使 用 HTML5 数 据 属 性 
e 在 弹 窗 中 显示 对 象 细节 
e 实现 不 间断 滚动 

e 实现 Like 部 件 

e 使 用 Ajax 上 传 图 片 


第 五 章 ? É 定义 模板 过 、， AX US 2T 


AD iP eae heirs 滤器 和 标签 ， 因 为 ，Django 的 模板 系统 包含 内 容 极 
,因此 可 以 有 更 多 的 东西 对 不 同 的 应 用 场景 来 添加 。 


e 遵循 模板 过 滤器 和 标签 的 约定 

e 创建 一 个 模板 过 滤器 以 显示 经 过 的 天 数 

e 创建 一 个 模板 过 滤器 提取 第 一 个 媒体 对 象 

e 创建 一 个 模板 过 滤器 使 URL 可 读 

e 创建 一 个 模板 标 zi & JP HR A— 4 QuerySet 
e 创建 一 个 模板 标签 为 模板 解析 内 容 

e 创建 一 个 模板 标签 修改 request 查 询 参 数 





第 六 章 ， 模 型 管理 


本 章 ， 将 指导 你 通过 扩展 默认 管理 带 上 自 定义 的 功能 ， 就 和 Dijango 框 架 自 带 的 预 构建 的 模型 
管理 一 样 好 用 。 


e 定制 换 表 页 面 中 列 

e 新 建 admin 的 行为 

e 开发 换 表 的 过 滤器 

。 为 外 部 的 应 用 交换 管理 上 的 设置 
。 将 地 图 插入 到 交换 表单 


第 七 章 ，Django CMS 


e ADjango CMS 创建 模板 

e 组 织 页 面 按钮 

。 将 一 个 应 用 转换 为 CMS 应 用 
e 添加 自己 的 导航 

e 编写 自 定 义 的 CMS 插 件 

e 对 CMS 页 面 添加 新 的 字段 


第 八 草 ， 层 级 结构 


e 生成 层级 目录 

。 利用 django-mptt-admin 新 建 一 个 目录 的 管理 接口 

e 使 用 django-mptt-tree-editor 创 建 一 个 目录 的 管理 接口 
e 在 模板 中 泻 染 目录 

在 表单 中 利用 一 个 单 选 字段 来 选择 一 个 目录 


于 表单 之 中 使 用 一 个 多 选 框 列 表 来 选择 多 个 字段 


第 九 章 ， 数 据 的 导入 和 导出 


从 本 地 的 CSV 文 件 中 导入 数据 
由 本 地 Excel 文 件 导入 数据 

打 外 部 JSON 文 件 导 入 数据 

自 外 部 XML 文件 导入 数据 
创建 可 过 滤 的 RSS 订 阅 

使 用 Tastypie 为 第 三 方 提供 数据 


第 十 草 ， 附 加 功能 


使 用 Django 的 命令 行 

Using the Django shell 

The monkey patching slugification function 

The monkey patching model administration 
Toggling Debug Toolbar 

Using ThreadLocalMiddleware 

Caching the method value 

Getting detailed error reporting via e-mail 
Deploying on Apache with mod wsgi 

Creating and using the Fabric deployment script 


本 章 我 们 会 学 习 到 以 下 内 容 : 


e 使 用 虚拟 环境 

。 创建 一 个 项 目 文件 结构 

e 用 pip 处 理 项 目 依赖 

e 在 项 目 中 包括 外 部 的 依赖 

e 在 settings 中 定义 相对 路 径 

e 为 Subersion 用 户 动态 地 配置 STATIC_URL 
e 为 Git 用 户 动态 地 配置 STATIC_URL 

。 创建 并 包括 本 地 设置 

e 把 UTF-8 设 置 为 MySQL 配 置 的 默认 编码 格式 
e 设置 Subversion 的 忽略 特性 

e 创建 Git 的 忽略 文件 

e 删除 Python 编译 文件 

e Python 文件 中 的 导入 顺序 

e 定义 可 重 写 的 app 设 置 


ms 
wh 


为 子 版 本 用 户 动 态 地 设置 STATIC_URL 


如 果 你 对 STATIC_URL 设置 一 个 静态 值 ， 那 么 每 次 你 更 新 CSS 文 件 ，JavaScript 文 件 ， 或 者 图 
片 都 需要 清除 浏览 器 的 缓存 以 应 用 改变 。 有 一 个 


预 热 
具体 做 法 
实现 原理 
参见 


为 Git 用 户 动态 地 设置 STATIC_URL 
预 热 


确保 你 的 项 目 处 理 Git 版 本 控制 器 之 下 。 


具体 做 法 


` 


实现 原理 


创建 并 包含 本 地 设置 


你 不 得 不 需要 至 少 两 个 不 同 的 项 目 实例 : 一 个 是 创建 新 特性 的 开发 环境 ， 另 一 个 是 托管 服务 
器 中 的 公开 网 站 环境 。 此 外 ， 可 能 会 有 针对 其 他 开发 者 的 不 同 的 开发 环境 。 你 或 许 也 需要 有 
一 个 过 渡 性 的 环境 以 在 一 个 类 公开 网 站 这 样 的 情况 下 测试 项 目 。 


FR 


NO ANSN 


不 同 环境 的 大 多 数 设 置 都 会 共享 并 保存 在 版 本 控制 中 。 不 过 ， 这 里 仍 人 会 有 一 些 针 对 某 些 项 
目 环境 的 特别 设置 ， 例 如 ， 数 据 库 或 者 电子 邮件 设置 。 我 们 把 它们 都 放 
进 local settings.py 文件 中 。 


具体 做 法 


执行 以 下 步骤 : 


1. 在 local settings.py 的 尾部 添加 声明 在 相同 目录 下 的 local_settings.py 的 描述 : 


#settings.py 
Ho... 把 这 些 代码 放 到 文件 的 结尾 .. 
Eny: 
execfile(os.path.join(os.path.dirname( file ), ';local_settings')) 
except IOError: 
pass 


1. 创建 local settings.py 然后 把 特定 的 环境 设置 加 入 到 文件 中 : 


4local settings.py 
DATABASES = { 
"default": { 
"ENGINE": "django.db.backends.mysql", 
"NAME": "myproject", 
SUSER OO, 
"PASSWORD": "root", 
} 
} 


} 
EMAIL BACKEND = "django.core.mail.backends.console.EmailBackend" 
INSTALLED APPS += ( 
"debug toolbar", 
) 


工作 原理 


如 你 所 见 ， 本 地 设置 并 没有 正常 地 导入 ， 它 们 却 包含 在 settings.py 中 并 被 执行 。 这 样 不 仅 允 
许 你 创建 或 者 重 写 存在 的 设置 ， 而 且 也 可 以 调整 settings.py 文件 中 元 组 或 者 列表 ; 例如 ， 这 
里 我 们 添加 debug toolbar 到 INSTALLED_APPS 以 启用 对 SQL 查询 ， 模 板 上 下 文 变 量 ， 等 等 的 调 
试 。 


参见 


The Creating a project file structure recipe 
The Toggling Debug Toolbar recipe in Chapter 10, Bells and Whistles 


配置 UTF_8 作 为 MySQL 配 置 的 默认 编码 
预 热 

具体 做 法 

工作 原理 

设置 Subversion 的 忽略 特性 

预 热 


具体 做 法 
打开 命令 行 工 具 并 社会 默认 编辑 器 为 nano’ vi: vim 或 者 其 他 的 任何 你 个 人 喜欢 的 编辑 器 : 


$ export EDIOR=nano 


如 果 你 还 没有 选择 自己 喜欢 的 编辑 器 ， 我 推荐 使 用 nano 


参见 
创建 Git 的 忽略 文件 
预 热 


具体 做 法 


使 用 你 最 喜欢 的 文本 编辑 器 ， 在 Django 项 目的 根 目 录 下 创建 一 个 .gitinore 文件 ， 然 后 把 这 
些 文件 和 目录 放 进 刚 创建 的 文件 中 : 


* pyc 

/myproject/local settings.py 
/myproject/static/ 
/myproject/tmp/ 
/myproject/media/ 


工作 原理 


参见 


2 


The Setting the Subversion ignore property recipe 
删除 Python 的 编译 文件 

预 热 

具体 做 法 

IRSE 

参见 


Python 文 件 中 的 导入 顺序 


A ONE REL? ete Ae el AA oM oss CMT TUQUE 


和 你 自己 在 阅读 代码 时 相对 轻松 一 些 。 


预 热 


NAN 


在 Django 项 目 中 创建 一 个 虚拟 目录 。 


具体 做 法 


这 个 方法 会 向 你 演示 如 何 组 织 导入 。 


在 你 创建 的 Python 文 件 中 应 用 下 面 的 结构 。 然 后 要 做 的 就 是 ， 在 第 一 行 定 义 UTF-8 作 为 默认 
的 Python 文件 编码 ， 并 把 分 类 的 导入 放 进 文件 区 域 : 


*- coding: UTF-8 -*- 
# System libraries 
import os 
import re 
from datetime import datetime 


# Third-party libraries 
import boto 
from PIL import Image 


# Django modules 
from django.db import models 
from django.conf import settings 


# Django apps 
from cms.models import Page 


# Current-app modules 
import app_settings 


工作 原理 


如 下 ， 我 们 有 五 个 主要 的 目录 被 导入 : 


更 多 内 容 
参见 


定义 可 重 写 的 app 设 置 


该 做 法 会 向 你 演示 如 何 给 应 用 定义 设置 ， 它 可 以 在 之 后 于 项 目的 settings.py 或 


者 local settings.py 文件 中 被 重 写 


。 对 于 可 重复 使 用 的 应 用 该 做 法 特别 有 效 。 


TR # 


手动 地 创建 Django 应 用 ， 或 者 利用 下 面 的 这 个 命令 : 


(myproject_env)$ django-admin.py startapp myappi 


具体 做 法 


如 果 你 刚好 有 一 个 到 两 个 设置 ， 你 可 以 在 models.py 中 使 用 下 面 的 模式 。 如 果 设 置 也 很 多 ， 
你 刚好 也 想 要 更 好 的 组 织 它 们 ， 那 么 你 可 以 在 应 用 中 创建 一 个 文件 app settings.py ， 然 后 以 
下 列 方 式 写 设置 : 


#models.py or app settings.py 

# -*- coding: UTF-8 -*- 

from django.conf import settings 

from django.utils.translation import ugettext lazy as _ 


SETTING1 = getattr(settings, "MYAPP1 SETTING1", u"default value") 
MEANING OF LIFE - getattr(settings, "MYAPP1 MEANING OF LIFE", 42) 
STATUS CHOICES = getattr(settings, "MYAPP1 STATUS CHOICES", ( 
(Micra (UD afit D> 
('published',  ("Published")), 
(Choealistedyy e Not Brusted Dy 
)) 


然后 ， 你 可 以 在 models.py 中 以 下 面 的 方法 使 用 应 用 的 设置 : 


#models.py 

# -*- coding: UTF-8 -*- 

from django.db import models 

from django.utils.translation import ugettext lazy as _ 


from app settings import STATUS CHOICES 


class NewsArticle(models.Model): 
i eT 
status - models.CharField( ("Status"), 
max length-z20, choices-STATUS CHOICES 
) 


如 果 你 想 要 为 一 个 项 目 重 写 status_cuorces ， 你 只 需 简单 地 打开 settings.py 并 加 入 下 面 代 
A. 


#settings.py 
Wu pod 
from django.utils.translation import ugettext_lazy as _ 
MYAPP1_STATUS_CHOICES = ( 
("imported", _("Imported")), 
Cral ta e (UD afit 
("published",  ("Published")), 
Cnoc iistedir na( Not rsted Dy 
(expaunea me Expuied5r 


工作 原理 


Python% žk > getattr(object, attribute name[, default value]) ， 视 图 从 object RRA 
TE attribute name ， 如 果 未 找到 属性 则 返回 default value 。 这 个 例子 中 ， 不 同 的 设置 从 
Django 项 目 设置 模块 中 被 视图 取 回 ， 如 果 这 些 设置 没 找到 ， 则 默认 值 被 使 用 。 


第 二 章 数据 库 结构 


本 章节 履 盖 以 下 议题 : 


e 使 用 模型 mixin 

e. 使 用 相对 URL 方 法 创建 一 个 模型 mixin 

e 创建 一 个 模型 mixin 以 处 理 日 期 的 创建 和 修改 

e 创建 一 个 模型 mixin 以 处 理 meta 标 签 

。 创建 一 个 模型 mixin 以 处 理 通 用 关系 

e 处 理 多 语言 字段 

使 用 South 迁 移 ( 译 者 注 : Django1.7 中 已 经 有 了 自己 迁移 模块 ， 故 内 容 将 略 去 ) 
使 用 South 将 一 个 外 键 改变 为 多 对 多 字段 


引言 


当 你 新 建新 的 app 时 ， 要 做 的 第 一 件 事 就 是 创建 表现 数据 库 结构 的 模型 。 我 们 假设 你 之 前 已 经 
创建 了 Django 的 app， 要 是 没有 话 马 上 创建 一 个 ， 而 且 你 也 阅读 并 了 解 Django 的 官方 教程 。 

本 章 ， 我 会 向 你 演示 一 些 让 数据 库 结构 在 项 目的 不 同 应 用 中 保持 一 致 的 有 趣 的 技术 。 然 后 我 
将 向 你 演示 创建 模型 字段 以 处 理 数据 库 中 的 数据 的 国际 化 。 本 章 的 最 后 ， 我 会 向 你 演示 在 开 
发 的 过 程 中 如 何 使 用 迁移 来 改变 数据 库 结 构 。 


AL n " 
使 用 模型 mixin 
在 Python 这 样 的 面向 对 象 语言 中 ，mixin 类 可 以 被 视 为 一 个 实现 功能 的 接口 。 当 一 个 模型 扩展 


了 一 个 mixin， 它 就 实现 了 接口 ， 并 包括 了 mixin 的 所 有 字段 ， 特 性 ， 和 方法 。 当 你 想 要 在 不 同 
的 模型 中 重复 地 使 用 通用 功能 时 ， 可 以 使 用 Django 模 型 的 mixin 。 


TR 2^ 
要 开始 的 话 ， 你 需要 创建 一 些 可 重复 使 用 的 mixin。mixin 的 某 些 典型 例子 会 在 后 面 章 节 展 示 。 


一 个 保存 模型 mixin 的 好 地 方 就 是 utils 模块 。 


如 果 你 要 创建 一 个 与 他 人 共享 的 重复 使 用 app， 那 就 要 把 模型 mixin 放 在 app 里 ， 比 如 放 在 
应 用 的 base.py 文件 中 ii 


具体 做 法 


在 任何 想 要 使 用 的 mixin 的 Django 应 用 中 ， 创 建 models.py 文件 ， 并 输入 下 面 的 代码 : 


#demo_app/models.py 

# -*- coding: UTF-8 -*- 

from django.db import models 

from django.utils.translation import ugettext_lazy as _ 
from utils.models import UrlMixin 

from utils.models import CreationModificationMixin 

from utils.models import MetaTagsMixin 


class Idea(UrlMixin, CreationModificationMixin, MetaTagsMixin): 
title = models.CharField( ("Title"), max length-26060) 
content - models.TextField( ("Content")) 
class Meta: 
verbose name - ("Idea") 
verbose name plural - ("Ideas") 


def unicode (self): 
return self.title 


工作 原理 


Django 的 模型 继承 支持 三 种 类 型 的 继承 : 抽象 基 类 ， 多 重 继承 ， 以 及 代理 模型 。 模 型 mixin 有 是 
拥有 特定 字段 ， 属 性 ， 和 方法 的 抽象 模型 类 。 当 你 创建 前 面 的 例子 所 示 Idea 这 样 的 模型 时 ， 
它 从 urlMixin , CreationModificationMixin 和 MetaTagsMixin 继承 了 所 有 功能 g 所 有 的 抽象 类 
字段 都 作为 所 扩展 模型 的 字段 被 保存 在 相同 的 数据 库 表 中 。 


还 有 更 多 呢 


为 了 学 习 更 多 不 同类 型 的 模型 继承 ， 参 考 Django 官 方 文档 
https://docs.djangoproject.com/en/dev/topics/db/models/#model-inheritance ° 


参见 


e 使 用 相对 URL 方 法 创建 一 个 模型 mixin 技 巧 
e 创建 模型 mixin 以 处 理 日 期 的 创建 和 修改 
e 创建 模型 mixin 以 处 理 meta 标 签 


使 用 相对 URL 方 法 创建 一 个 模型 mixin 


每 个 模型 都 有 自己 的 页 面 ， 定义 get absolute url() 方法 是 很 好 的 做 法 。 这 个 方法 可 以 用 在 
模板 中 ， 它 也 可 以 用 在 Django admin 站 点 中 以 预览 所 保存 的 项 目 。 然 

而 ， get absolute url 很 不 明确 ， 因 为 它 实际 上 返回 的 是 URL 路 径 而 不 是 完整 的 URL。 在 这 
个 做 法 ， 我 会 向 你 演示 如 何 创建 一 个 模型 mixin， 默 认 它 允许 你 定义 URL 路 径 或 者 完整 的 
URL， 以 生成 一 个 开 箱 即 用 的 URL， 并 处 理 get absolute url 方法 的 设置 事宜 。 


预备 ! 


如 果 你 还 没有 完成 创 保存 mixin 的 utils 包 。 然 后 ， 在 utils 包 内 (可 选 的 是 ， 如 果 创 建 了 一 
个 重复 使 用 的 应 用 ， 那 么 你 需要 把 base.py 放 在 应 用 中 ) 创建 models.py 文件 。 


具体 做 法 


按 步骤 地 执行 以 下 命令 : 


1. 在 utils 包 的 models.py 文件 中 添加 以 下 内 容 : 


#utils/models.py 

# -*- coding: UTF-8 -*- 

import urlparse 

from django.db import models 

from django.contrib.sites.models import Site 
from django.conf import settings 


class UrlMixin(models.Model): 


nim 


蔡 换 get_absolute_url()。 模 型 扩展 该 mixin 便 可 以 执行 get_url 或 者 get_url path。 
class Meta: 
abstract = True 


def get url(self): 
if hasattr(self.get url path, "dont recurse"): 
raise NotImplementedError 
SELENE 
path = self.get_url_path() 
except NotImplementedError: 
raise 
website url = getattr(settings, "DEFAULT WEBSITE URL", "http://127.0.0.1:8000") 
return website url + path 
get url.dont recurse - True 


def get url path(self): 
if hasattr(self.get url, "dont recurse"): 
raise NotImplementedError 
iE] AR 
url - self.get url() 
except NotImplementedError: 
raise 
bits - urlparse.urlparse(url) 
return urlparse.urlunparse(("", "") + bits[2:]) 
get url path.dont recurse - True 


def get absolute url(self): 
return self.get url path() 


E 


1. 为 了 在 应 用 中 使 用 mixin， 需 要 把 它 从 utils 包 导 入 ， 然 后 在 模型 类 中 继承 mixin， 并 定 
3L get absolute url() 方法 如 下 : 





à demo app/models.py 

# -*- coding: UTF-8 -*- 

from django.db import models 

from django.utils.translation import ugettext lazy as _ 
from django.core.urlresolvers import reverse 

from utils.models import UrlMixin 


class Idea(UrlMixin): 
title = models.CharField( ("Title"), max length-26060) 
Hous 
deiegetauGgliMmpatht(seln is 
return reverse("idea_details", kwargs={ 
"idea_id": str(self.pk) 
1) 


1. 如果 你 在 临时 或 者 生产 环境 中 检查 该 代码 ， 抑 或 你 在 本 地 运行 不 同 的 IP 或 者 端口 的 服务 
器 ， 那 么 你 需要 在 本 地 设置 的 DEFAULT_WEBSITE_URL 中 设置 如 下 内 容 : 
#settings.py 


W/ uo 
DEFAULT WEBSITE URL - "http://www.example.com" 


工作 原理 


UrlMixin 是 一 个 拥有 三 种 方法 的 抽象 模型 : get_url() ， 

get url path() * get absolute url 。 get url() 或 者 get url path() 方法 期 待 在 所 扩展 的 模型 类 中 被 重 : 
Idea 类 。 你 可 定义 get url ， 它 是 一 个 到 对 象 的 完整 URL， get url path 会 把 它 剥 离 到 路 径 。 你 也 可 以 定义 get 
url path ， 它 是 到 对 象 的 绝对 路 径 ， 然 后 get. url. 会 添加 网 站 的 URL 到 路 径 的 开始 。 get absolute url 方法 会 上 
get url path' ° 


提示 

通常 的 经 验 总 是 重 写 get url path() 方法 。 

当 你 在 同一 个 网 站 中 需要 到 一 个 对 象 的 链接 ， 可 以 在 模板 中 ， 使 用 <a href=""></a> 。 对 
于 电子 邮件 ，RSS 订 阅 或 者 API 可 以 使 用 ， «a href=">"</a> ° 


参阅 


使 用 模型 mixin 
创建 处 理 数据 生成 和 修改 的 模型 mixin 
创建 模型 mixin 以 处 理 元 标签 


创建 模型 mixin 处 理 通用 关系 


创建 处 理 数据 生成 和 修改 的 模型 mixin 


在 模型 中 对 于 模型 实例 的 创建 和 修改 来 说 ， 一 种 常见 的 行为 就 是 拥有 时 间 改 。 该 方法 中 ， 我 
会 向 你 演示 如 何 给 创建 保存 、 修 改 模型 的 日 期 和 时 间 。 使 用 这 样 的 mixin， 可 以 保证 所 有 的 模 
型 对 于 时 间 改 都 使 用 相同 的 字段 ， 以 及 拥有 同样 的 行为 。 


准备 开始 


如 果 你 还 没有 完成 创 保存 mixin 的 utils 包 。 然 后 ， 在 utils 包 内 (可 选 的 是 ， 如 果 创 建 了 一 
个 重复 使 用 的 应 用 ， 那 么 你 需要 把 base.py 放 在 应 用 中 ) 创建 models.py 文件 。 


如 何 做 
打开 utils 包 中 的 models.py 文件 ， 并 输入 以 下 的 代码 : 


#utils/models.py 

# -*- coding: UTF-8 -*- 
from django.db import models 

from django.utils.translation import ugettext_lazy as _ 
from django.utils.timezone import now as timezone_now 


class CreationModificationDateMixin(models.Model): 


可 以 创建 和 修改 日 期 和 时 间 的 抽象 基 类 。 
created = models.DateTimeField( 
("creation date and time"), 
editable-False, 


) 


modified = models.DateTimeField( 
_("modification date and time"), 
null=True, 
editable=False, 


) 


def save(self, *args, **kwargs): 
if not self.pk: 
self.created = timezone now() 
else: 
# 为 了 保证 我 们 一 直 拥 有 创建 数据 ， 添 加 下 面 的 条 件 语句 
if not self.created: 
self.created - timezone now() 
self.modified - timezone now() 


super(CreationModificationDateMixin, self).save(*args, **kwargs) 
save.alters data - True 


class Meta: 
abstract - True 


工作 原理 


CreationModificationDateMixin 类 是 一 个 抽象 模型 ， 这 意味 着 它 所 扩展 的 模型 类 会 在 同一 个 数 
据 表 中 创建 所 有 字段 ， 即 ， 没 有 一 对 一 关系 让 表 变 得 难以 处 理 。 该 mixin 拥 有 两 个 日 期 -时 间 字 
段 ， 以 及 一 个 在 保存 扩展 模型 会 调用 的 save() 方法 。 save() 方法 检查 模型 是 否 拥 有 主键 ， 
这 是 一 种 新 建 但 还 未 保存 的 实例 的 情况 。 否 则 ， 如 果 主 键 存在 ， 修 改 的 日 期 就 会 被 设置 为 当 
前 的 日 期 和 时 间 。 


作为 选择 ， 你 可 以 不 使 用 save() 方法 ， 而 使 用 auto now add 和 auto now 属性 
来 created 和 修改 字段 以 自动 地 创建 和 修改 时 间 戳 。 


参阅 
使 用 模型 mixin 


创建 模型 mixin 以 处 理 meta 标 签 
创建 模型 mixin 以 处 理 通 用 关系 


创建 模型 mixin 以 处 理 meta 标 签 
如 果 你 想 要 为 搜索 引擎 而 优化 网 站 ， 那 么 你 不 仅 需 要 个 每 个 页 面 都 设置 语义 装饰 ， 而 且 也 需 
要 合适 的 元 标签 。 为 了 最 大 的 灵活 性 ， 你 需要 有 一 种 对 在 网 站 中 有 自己 页 面 的 所 有 对 象 都 定 


义 指 定 的 元 标签 的 方法 。 于 此 技法 中 ， 我 们 会 向 你 演示 如 何 对 字段 和 方法 创建 一 个 mixin 以 关 
联 到 元 标签 。 


准备 开始 叶 ! 


和 前 面 的 做 法 一 样 ， 确 保 你 为 mixin 备 好 了 utils 包 。 用 你 最 喜欢 的 编辑 器 打开 models.py X 
件 。 


具体 做 法 


T models.py 文件 写 入 以 下 内 容 : 


Django 网 站 开发 Cookbook 


#utils/models.py 

# -*- coding: UTF-8 -*- 

from django.db import models 

from django.utils.translation import ugettext_lazy as _ 
from django.template.defaultfilters import escape 

from django.utils.safestring import mark_safe 


class MetaTagsMixin(models.Model): 


用 于 <head> 元 素 中 由 抽象 基 类 所 构成 的 元 标签 

meta keywords = models.CharField( 
("Keywords"), 
max length-255, 
blank=True, 
help_text=_("Separate keywords by comma."), 

) 

meta description = models.CharField( 
_("Description"), 
max_length=255, 
blank=True, 


meta_author = models.CharField( 
_("Author"), 
max_length=255, 
blank=True, 

) 

meta_copyright = models.CharField( 
_("Copyright"), 
max_length=255, 
blank=True, 

) 


class Meta: 
abstract = True 


def get_meta_keyword(self): 
tag = u LLI W 
if self.meta_keywords: 
tag = u'<meta name="keywords" content="{}".format(escape(self.meta_author)) / 
return mark_safe(tag) 


def get_meta_description(self): 
tag = ies LLI 
if self.meta description: 
tag = u'«meta name="description" content="{1}".format(escape(self.meta_author 
return mark_safe(tag) 


def get_meta_author(self): 
tag = u LLI W 
if self.get_meta_author: 
tag = u'«meta name-"author" content="{1}".format(escape(self.meta_author)) /> 


def get_meta_copyright(self): 
tag = u" W 
if self.meta_copyright: 
tag = u'«meta name-"copyright" content="{}".format(escape(self.meta_copyright 
return mark_safe(tag) 


def get_meta_tags(self): 
return mark_safe(u" ".join( 
self.get_meta_keyword(), 
self.get_meta_description(), 
self.get meta author(), 
self.get meta copyright(), 
)) 





工作 原理 


该 mixin 添 加 了 四 个 字段 到 模型 扩 
展 : meta keywords, meta description, meta author 和 meta copyright 。 在 HTML 中 泻 汪 元 标 
签 的 方法 也 添加 了 。 


如 果 你 在 Idea 这 样 的 模型 中 使 用 mixin， 它 出 现在 本 章 的 第 一 个 方法 ， 那 么 你 可 以 在 目的 是 
泻 染 所 有 元 标签 的 详细 页 面 模板 的 HEAD 部 分 中 写 入 以 下 内 容 : 


{{ ieda.get meta tags }} 


你 也 可 以 利用 下 面 的 行 来 泻 染 一 个 特定 的 元 标签 : 
{{ idea.get meta description }} 
或 许 你 也 注意 到 了 代码 片段 ， 浑 染 的 元 标签 被 标记 为 安全 ， 即 ， 它 们 没有 被 转 义 而 且 我 们 也 


不 要 使 用 safe 模板 过 滤器 。 只 有 来 自 数据 库 中 的 值 才 被 转 义 ， 以 保证 最 终 的 HTML 成 型 良 
好 。 


参见 


使 用 模型 mixin 
创建 一 个 模型 mixin 以 处 理 日 期 的 创建 和 修改 
创建 一 个 模型 mixin 以 处 理 通用 关系 


创建 模型 mixin 以 处 理 通用 关系 


除了 外 键 关 系 或 者 对 对 关系 这 样 的 正常 的 数据 库 关 系 之 外 ，Django 还 提供 了 一 种 关联 一 个 模 
型 到 任意 模型 的 实例 。 此 概念 称 为 通用 关系 。 每 个 通用 关系 都 有 一 个 关联 模型 的 内 容 类 型 ， 


而 且 这 个 内 容 类 型 保存 为 该 模型 实例 的 ID。 
该 方法 中 ， 我 们 会 向 你 演示 如 何 将 通用 关系 的 创建 归纳 为 模型 mixin。 
准备 开始 


要 让 该 方法 正常 运行 ， 你 需要 安装 contenttypes 应 用 。 默 认 它 应 该 位 于 INSTALLED_APPS 目录 


中 : 


INSTALLED APPS - ( 


# 


再 者 ， 


"django.contrib.contenttypes", 


要 确保 你 已 经 创建 了 放置 模型 mixin 的 utils & ° 


工作 原理 


在 文本 编辑 器 中 打开 utils 包 中 的 models.py 文件 ， 并 输入 以 下 的 内 容 : 


a“ 


#uti 
Prio te 
From 
From 
From 
From 
From 


def 


ls/models.py 

- coding: UTF-8 -*- 

django.db import models 

django.utils.translation import ugettext lazy as _ 
django.contrib.contenttypes.models import ContentType 
django.contrib.contenttypes import generic 
django.core.exceptions import FieldError 


object relation mixin factory( 
prefix=None, 

prefix_verbose=None, 
add_related_name=False, 
limit_content_type_choices_to={}, 
limit_object_choices_to={}, 
is_required=False, 


返回 一 个 使 用 含有 动态 字段 名 称 的 “Content type - object Id 的 mixin 类 的 通用 外 键 。 
该 函数 只 是 一 个 类 生成 器 。 
prefix : 前 级 用 来 添加 到 字段 的 前 面 
prefix verbose : 前 级 的 元 余 名 称 ， 用 来 生成 Admin 中 内 容 对 象 的 字段 列 的 title 
add_related_name : 表示 一 个 布尔 值 ， 


工作 原理 


参见 


The Creating a model mixin with URL-related methods recipe 


The Creating a model mixin to handle creation and modification dates recipe 


The Creating a model mixin to take care of meta tags recipe 
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具体 做 法 
工作 原理 


1& M Southit % 
略 。Dijango1.7 已 经 自 带 迁移 模块 。 
使 用 South 将 一 个 外 键 改 变 为 


wh ° 
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第 三 章 -表单 和 视图 


在 本 章 ， 我 们 学 习 以 下 内 容 : 


e 传递 HttpRequest 到 表单 

e 利用 表单 的 save 方 法 

e 使 用 django-crispy-forms 生 成 表单 布局 
e 过 滤 对 象 列 表 

。 管理 分 页 列表 

。 编写 类 视图 

e 生成 PDF 文档 


引言 


当 数 据 库 结 构 定 在 模型 中 时 ， 我 们 需要 有 一 些 视图 供用 户 输入 数据 ， 或 者 对 用 户 显示 数据 。 
本 章 ， 我 们 会 关注 管理 表单 的 视图 ， 列 表 视 图 ， 以 及 生成 可 替换 的 输出 而 不 仅仅 是 HTML。 举 
个 最 简单 的 例子 来 说 ， 我 们 将 把 模板 和 URL 规 则 的 创建 的 决定 权 下 放 给 你 。 


传递 HttpRequest 到 表单 


Djangon ope ped SUR 常 是 命名 为 request 的 HttpRequest 对 象 。 它 包含 了 请 
求 的 元 数据 ， 例 如 ， 当 前 语言 编码 ， 当 前 用 户 ， 当 前 cookie， 或 者 是 当前 的 Session。 默 认 ， 
表单 被 用 在 视图 中 用 来 接受 GET 或 者 POST 参数 ， 文 件 ， 初 始 化 数据 ， 以 及 其 他 的 参数 ， 但 却 
不 是 HttpRequest Xt RI 9 xo T 况 下 ， 特别 是 当 你 想 要 使 用 请 求 数 据 过 滤 出 表单 字段 的 选 
择 ， 又 或 者 是 你 想 要 处 理 像 在 表单 中 保存 当前 用 户 或 者 当前 IP 这 样 事情 时 ， 额 外 地 传递 

地 HttpRequest 到 表单 会 非常 有 用 的 。 


在 本 方法 中 ， 我 会 向 你 展示 一 个 在 表单 中 某 人 可 以 选择 一 个 用 户 并 对 此 用 户 发 送 消息 的 合 
子 。 我 们 会 传递 HttpRequest 对 象 到 表单 以 暴露 接受 选项 的 当 前 用 户 : 我 们 不 想 要 任何 人 都 可 
以 给 他 们 发 送 消息 。 


预 热 


让 我 们 来 创建 一 个 叫做 email messages 的 应 用 ， 并 把 它 放 到 设置 中 的 INSTALLED_APPS X ° HK 
app 仅 含有 表单 和 视图 而 没有 模型 。 


具体 做 法 


1. 添加 一 个 新 文件 >? forms.py ， 其 中 消 息 表单 包含 两 个 字段 : 接收 人 选项 和 消 息 文 本 。 同 
时 ， 该 表单 拥有 一 个 初始 化 方法 ， 它 会 接受 request 对 象 并 对 接收 和 的 选项 字段 修改 : 


# -*- coding: UTF-8 -*- 

from django import forms 

from django.utils.translation import ugettext lazy as _ 
from django.contrib.auth.models import User 


class MessageForm(forms.Form): 

recipient - forms.ModelChoiceField( 
label- ("Recipient"), 
queryset-User.objects.all(), 
required=True, 

) 

message = forms.CharField( 
label- ("Message"), 
widget-forms.Textarea, 
required=True, 


) 


def init__(self, request, *args, **kwargs): 
super(MessageForm, self). init (*args, **kwargs) 
self.request - request 
self.fields['recipient'].queryset - self.fields['recipient'].queryset.exclude(pk- 


[racer — C: -——á É— —— !'— — 


1. 然后 ， 利 用 message to user 视图 创建 views.py 以 处 理 表 单 。 如 你 所 见 ， request xg 
作为 第 一 个 参数 被 传递 到 了 表单 : 





#email_messages/views.py 

# -*- coding: UTF-8 -*- 

from django.contrib.auth.decorators import login_required 
from django.shortcuts import render, redirect 


from forms import MessageForm 


@login_required 
def message_to_user(request): 
if request.method == "POST": 
form = MessageForm(request, data-request.POST) 
if form.is_valid(): 
# do something with the form 
return redirect("message to user done") 
else: 
form = MessageForm(request) 
return render(request, "email messages/message to user.html", {'form:form'}) 


工作 原理 


在 初始 化 方法 中 ， 我 们 拥有 表现 表单 自身 实例 的 self 变量 ， 然 后 是 新 近 添 加 的 request € 
量 ， 在 然后 是 位 置 参数 〈( *args ) 和 命名 参数 ( **kwargs ) 。 我 们 调用 super 构造 方法 传递 
所 有 的 位 置 参 数 以 及 命名 参数 ， 这 样 表单 就 可 以 正确 地 初始 化 。 接 着 ， 我 们 把 request 变量 
赋值 到 一 个 新 的 表单 的 request. 变量 ， 以 便 之 后 在 表单 的 其 他 方法 中 可 以 访问 。 再 然后 ， 我 
们 修改 接收 人 选项 字段 的 queryset 属性 以 便 从 request 暴 露 当 前 用 户 。 


在 视图 中 ， 我 们 将 uttpRequest 作为 两 种 场合 下 的 第 一 个 参数 来 传递 : 当 表 单 第 一 次 载 入 时 ， 
以 及 表单 发 布 之 后 。 


表单 的 save 方 法 的 使 用 


表单 的 save 方 法 使 用 

为 了 让 视图 变 得 简洁 和 简单 ， 最 好 的 做 法 是 移动 表单 数据 的 处 理 到 表单 本 身 ， 不 论 是 否 可 
行 。 常 见 的 做 法 是 利用 一 个 可 以 保存 数据 的 save 方 法 来 执行 搜索 ， 或 者 来 完成 其 他 的 复杂 的 
行为 。 我 们 利用 Save 方法 扩展 之 前 方法 中 所 定义 的 表单 ，save 方 法 会 发 送 电子 邮件 到 所 选择 
的 接收 人 。 


预备 开始 


我 们 从 定义 在 传递 HttpRequest 到 表单 这 个 例子 开始 。 


具体 做 法 


执行 以 下 两 步 : 


1. 在 应 用 的 表单 中 导入 郊 数 以 便 发 送 邮 件 。 然 后 添加 save 方 法 并 尝试 发 送 邮 件 到 所 选择 的 
接收 人 ， 发 生 错 误 时 静默 : 


#email_messages/forms.py 

# -*- coding: UTF-8 -*- 

from django import forms 

from django.utils.translation import ugettext, ugettext_lazy as _ 
from django.core.mail import send_mail 

from django.contrib.auth.models import User 


class MessageForm(forms.Form): 

recipient = forms.ModelChoiceField( 
label- ("Recipient"), 
queryset-User.objects.all(), 
required=True, 

) 

message = forms.CharField( 
label- ("Message"), 
widget-forms.Textarea, 
required-True, 


def init (self, request, *args, **kwargs): 
super(MessageForm, self). init (*args, **kwargs) 
self.request - request 
self.fields['recipient'].queryset = \ 
self.fields['recipient'].queryset.\ 
exclude(pk=request.user.pk) 


def save(self): 

cleaned_data = self.cleaned_data 

send_mail( 
subject=ugettext("A message from %s") % N 

self.request.user, 

message-cleaned data['message'], 
from email-self.request.user.email, 
recipient list-[cleaned data['recipient'].email], 
fail_silently=True, 


1. 最 后 ， 假 如 发 送 的 数据 有 效 ， 则 在 视图 中 调用 Save 方 法 : 


4email messages/views.py 

4 -*- coding: UTF-8 -*- 

from django.contrib.auth.decorators import login required 
from django.shortcuts import render, redirect 


from forms import MessageForm 


Ql1ogin required 
def message to user(request): 
if request.method -- "POST": 
form - MessageForm(request, data-request.POST) 
if form.is valid(): 
form.save() 
return redirect("message to user done") 
else: 
form = MessageForm(request ) 


return render(request, "email_messages/message_to_user.html",{'form': form}) 


工作 原理 


首先 让 我 们 看 下 表单 。save 方 法 使 用 来 自 表单 的 清洁 数据 来 读 取 接收 人 的 电邮 地 址 ， 以 及 电 
邮 信 息 。 电 邮 的 发 送 人 就 是 当前 的 request 中 的 用 户 。 假 如 电邮 由 于 不 正确 的 邮件 服务 器 配置 
或 者 其 他 原因 导致 未 能 发 送 ， 那 么 错误 也 是 静默 的 ， 即 ， 不 会 在 表单 中 抛 出 错误 。 


现在 ， 我 们 来 看 下 视图 。 当 用 户 发 送 的 表单 有 效 时 ， 表 单 的 save 方法 会 被 调用 ， 接 着 用 户 被 
重 定向 到 成 功 页 面 。 


参阅 


传递 HttpRequest 到 表单 


Efe B A 


于 此 做 法 中 ， 我 们 会 看 到 处 理 图 片上 传 的 最 简单 的 办 法 。 你 会 见 到 一 个 应 用 中 访客 可 以 上 传 
励志 名 言 图 片 的 例子 。 


预 热 


BADA] 


首先 ， 让 我 们 来 创建 一 个 应 用 quotes ， 并 把 它 放 到 设置 中 的 INSTALLED APPS. 。 然 后 ， 我 们 添 
加 一 个 拥有 三 个 字段 的 InspirationalQuote 模型 : 作者 ， 名 言 内 容 ， 以 及 图 片 ， 一 如 下 面 所 
T: 


#quotes/models.py 

#-*- coding:utf-8 -*- 

import os 

from django.db import models 

from django.utils.timezone import now as timezone_now 
from django.utils.translation impot ugetext_lazy as _ 


def upload_to(instance, filename): 
now = timezone now() 
filename base, filename ext = os.path.splitext(filename) 
return 'quotes{}{}'.format(now.strftime("%Y/%m/%Y%m%Ad%H%M%S"), filename ext.lower(),) 


class InspirationalQuote(models.Model): 
author = models.CharField( ("Author"), max_length=200) 
quote = models.TextField(_("Quote")) 
picture = mdoels.ImageField( ("Picture"), 
upload_to=upload_to, blank=True, null=True, 
) 


class Meta: 
verbose_name = _("Inspirational Quote") 
verbose_name_plural = _("Inspiration Quotes") 


def untcodem (sedi): 
return self.quote 








此 外 ， 我 们 创建 了 一 个 函数 upload to ,该 函数 设置 类 似 quotes/2014/04/20140424140000 这 样 
的 图 片上 传 路 径 。 你 也 看 到 了 ， 我 们 使 用 日 期 时 间 改 作为 文件 名 以 确保 文件 的 唯一 性 。 我 们 
传递 该 函数 到 picture 图 片 字段 。 


具体 做 法 
创建 forms.py 文件 ， 并 于 其 中 编写 一 个 简单 的 模型 表单 : 


#quotes/forms.py 

#-*- coding:utf-8 -*- 

from django import forms 

from models import InspirationQuote 


class InspirationQuoteForm(forms.ModelForm): 
class Meta: 
model - InspirationQuote 


在 views.py 文件 中 写 入 一 个 视图 以 处 理 表单 。 不 要 忘 了 传递 类 字典 对 象 FILES 到 表单 。 如 
下 ， 当 表单 有 效 时 便 会 触发 save 方法 : 


#quotes/views.py 

# -*- coding: UTF-8 -*- 

from django.shortcuts import redirect 
from django.shortcuts import render 
from forms import InspirationQuoteForm 


def add_quote(request): 
if request.method == 'POST': 
form = InspirationQuoteForm( 
data-request.POST, 
files-request.FIELS, 


if form.is valid(): 
quote - form.save() 
return redirect("add quote done") 
elise: 
form = InspirationQuoteForm( ) 
return render(request, "quotes/change quote.html", {'form': form}) 


最 后 ， 在 templates/quotes/change quote.html 中 给 视图 创建 一 个 模板 。 为 HTML 表 单 设 
置 enctype 属性 为 "multipart/form-data" 十 分 的 重要 ， 否则 文件 上 传 不 会 起 作用 的 : 


{% extends "base.html" %} 
{% load i18n %} 


{% block content %} 
<form method="post" action="" enctype-"multipart/form-data"» 
{% csrf_token %} 
{{ form.as_p }} 
«button type="submit">{% trans "Save" %} 
</button> 
</form> 
{% endblock %} 


工作 原理 


Django 的 模型 表单 通过 模型 生成 的 表单 。 它 们 提供 了 所 有 的 模型 字段 ， 因 此 你 不 要 重复 定义 
这 些 字段 。 前 面 的 例子 中 ， 我 们 给 InspirationQuote 模型 生成 了 一 个 模型 表单 。 当 我 们 保存 
表单 时 ， 表 单 知 道 如 何 包 每 个 字段 都 保存 到 数据 中 去 ， 也 知道 如 何 上 传 图 片 并 在 媒体 目录 中 
保存 这 些 图 片 。 


还 有 更 多 


作为 奖励 ， 我 会 想 你 演示 一 个 如 何 从 已 经 上 传 的 图 片 中 生成 一 个 缩 略 图 。 利 用 这 个 技术 ， 你 
也 可 以 生成 多 个 其 他 图 片 特定 的 版 本 ， 不 如 ， 列 表 版 本 ， 移 动 设备 版 本 ， 桌 面 电脑 版 本 。 


我 们 添加 三 个 方法 到 模型 Inspirationquote (quotes/modles.py) 。 它 们 是 

save,create thumbnail,feget thumbnail _picture_url。 当 模型 被 保存 时 ， 我 们 就 触发 了 缩 略 图 
的 创建 。 如 下 ， 当 我 们 需要 在 一 个 模板 中 显示 缩 略 图 时 ， 我 们 可 以 通过 使 

用 ££ quote.get thumbnail picture url }} 来 获取 图 片 的 URL : 


#quotes/models.py 
class InspirationQuote(models.Model): 
i? peo 
def save(self, *args, **kwargs): 
super(InspirationQuote, self).save(*args, **kwargs) 
H 生成 缩 略 图 
self.create thumbnail() 
def create thumbnail(self): 
from django.core.files.storage import default storage as \ 
storage 
if not self.picture: 
return "^ 
file path - self.picture.name 
filename base, filename ext - os.path.splitext(file path) 
thumbnail file path = "%s_thumbnail.jpg" % filename base 
if storage.exists(thumbnail file path): 
# if thumbnail version exists, return its url path 
# 如 果 缩 略图 存在 ， 则 返回 缩 略 图 的 Ur1 路 径 
return "exists" 
Ery: 
# resize the original image and 
# return URL path of the thumbnail version 
# 改变 原始 图 片 的 大 小 并 返回 缩 略 图 的 URL 路 径 
f = storage.open(file path, 'r') 
image - Image.open(f) 
width, height - image.size 
thumbnail size - 50, 50 


if width » height: 
delta - width - height 
left - int(delta/2) 


upper = 0 
right = height + left 
lower = height 

else: 
delta = height - width 
left = 0 
upper int(delta/2) 


right = width 
lower = width + upper 


image 
image 


= image.crop((left, upper, right, lower)) 

= image.resize(thumbnail_size, Image.ANTIALIAS) 
f mob = storage.open(thumbnail file path, "w") 
image.save(f mob, "JPEG") 
f mob.close() 
return "success" 

except: 
return "error" 


def get thumbnail picture url(self): 
from PIL import Image 
from django.core.files.storage import default storage as \ 
storage 
if not self.picture: 
return "^" 
file path - self.picture.name 
filename base, filename ext - os.path.splitext(file path) 
thumbnail file path = "%s_thumbnail.jpg" % filename base 
if storage.exists(thumbnail file path): 
# if thumbnail version exists, return its URL path 
# 如 果 缩 略图 存在 ， 则 返回 图 片 的 URL 路 径 
return storage.url(thumbnail file path) 
# return original as a fallback 
# 返回 一 个 图 片 的 原始 ur1 路 径 
return self.picture.url 


之 前 的 方法 中 ， 我 们 使 用 文件 存储 API 而 不 是 直接 地 与 应 对 文件 系统 ， 因 为 我 们 之 后 可 以 使 用 
亚马逊 的 云 平 台 ， 或 者 其 他 的 存储 服务 和 方法 来 与 默认 的 存储 切换 也 可 以 正常 工作 o 


缩 略 图 的 创建 具体 是 如 何 工作 的 ?如果 原始 图 片 保 存 为 quotes/2014/04/20140424140000.png ° 
我 们 
参见 


使 用 django-crispy-forms 创 建 表单 布局 


使 用 django-crispy-forms 创 建 表 单 布局 


Django 的 应 用 > django-crispy-forms 允许 你 使 用 下 面 的 CSS 框 架构 建 ， 定 制 ， 重 复 使 用 表 
单 : Uni-Form , Bootstrap , 或 者 Foundation ° django-crispy-form 49 F X 3& 4j. -T Django Bl 7 
管理 中 的 字段 集合 ， 而 且 它 更 高 级 ， 更 富 于 定制 化 。 按 照 Python 代码 定义 表单 布局 ， 而 且 你 
不 需要 太 过 关心 HTML 中 的 每 个 字段 。 假 如 你 需要 添加 指定 的 HTML 属 性 或 者 指定 的 外 观 ， 你 
仍旧 可 以 轻松 地 做 到 。 


这 个 方法 中 ， 我 们 会 向 你 演示 一 个 如 何 使 用 拥有 Bootstrap 3 一 一 它 是 开发 响应 式 ， 移 动 设 备 


优先 的 web 项 目的 最 流行 的 前 端 框架 一 的 django-crispy-forms。 


预 热 


aN 


我 们 一 步 接 一 步 地 执行 这 些 步骤 : 


1. 从 http:/getbootstrap.com/ 下 载 前 端 框架 Bootstrap 并 将 CSS 和 JavaScript 集 成 到 模板 。 更 多 
内 容 详 见 第 四 章 -模板 和 Javascript 中 的 ` 管 理 base.html 模 板 `。 


2. 使 用 下 面 的 命令 在 虚拟 环境 中 安装 django-crispy-forms : 


(myproject env)$ pip install django-crispy-forms 


3. 确 保 csirpy-form 添 加 到 了 iwsrALLED APPS ,然后 在 该 项 目 中 设置 bootstrap3 作为 模板 包 来 合 
用 : 

#settings.py 

INSTALLED_APPS = ( 


"crispy forms", 


CRISPY TEMPLATE PACK = "bootstrap3" 


4. 让 我 们 来 创建 一 个 应 用 bulletin board 来 阅 明 django-crispy-forms 的 用 法 ， 并 把 应 用 添加 到 
设置 中 的 INSTALLED_APPS 。 我 们 会 拥有 一 个 含有 这 些 字段 的 Bulletin 模型 : 类 型 ， 名 称 ， 描 
述 ， 联 系 人 ， 电 话 ， 电 邮 ， 以 及 图 片 : 


#bulletin_board/models. py 
# -*- coding: UTF-8 -*- 
from django.db import models 


from django.utils.translation import ugettext_lazy as _ 


TYPE_CHOICES = ( 
('searching', _("Searching")), 
(‘offering', -("offering")), 

) 


class Bulletin(models.Model): 

bulletin type = models.CharField( ("Type"), max_length=20, choices=TYPE_CHOICES) 

title = models.CharField( ("Title"), max length-255) 

description = models.TextField( ("bescription"),max length-306) 

contact person - models.CharField( ("Contact person"), 
max lengthz255) 

phone = models.CharField( ("Phone"), max_length=200, blank=True) 

email = models.EmailField(_("Email"), blank=True) 

image = models.ImageField( ("Image"), max_length=255, 
upload_to="bulletin_board/", blank=True) 


class Meta: 
verbose_name = _("Bulletin") 
verbose_name_plural = _("Bulletins") 
ordering = ("title",) 


def unicode. (self): 
return self.title 


具体 做 法 


Let's add a model form for the bulletin in the newly created app. We will attach a form helper 
to the form itself in the initialization method. The form helper will have the layout property, 
which will define the layout for the form, as follows: 


4bulletin board/forms.py 

# -*- coding: UTF-8 -*- 

from django import forms 

from django.utils.translation import ugettext lazy as _, ugettext 
from crispy forms.helper import FormHelper 

from crispy forms import layout, bootstrap 

from models import Bulletin 


class BulletinForm(forms.ModelForm): 
class Meta: 
model - Bulletin 
fields - ['bulletin type', 'title', 'description', 
'contact person', 'phone', 'email', 'image'] 


def — init (self, *args, **kwargs): 
super(BulletinForm, self). (init (*args, **kwargs) 


self.helper - FormHelper() 
self.helper.form action = "" 
self.helper.form method - "POST" 


self.fields['bulletin type'].widget - forms.RadioSelect() 
# delete empty choice for the type 
del self.fields['bulletin type'].choices[0] 


self.helper.layout - layout.Layout( 
layout.Fieldset( 
("Main data"), 
layout.Field("bulletin type"), 
layout.Field("title", css class-"input-block-level"), 
layout.Field("description", 
css class-"input-blocklevel", rows="3"), 
), 
layout.Fieldset( 
a "Image" ) " 
layout.Field("image", css classz"input-block-level"), 
layout.HTML(u"""{% load ii18n %} 
«p class="help-block">{% trans "Available formats are JPG, GIF, and P 
n" ED 
title- ("Image upload"), 
css id-"image fieldset", 
), 
layout.Fieldset( 
m OContacte) 
layout.Field("contact person", 
css class-"input-blocklevel"), 
layout.Div( 
bootstrap.PrependedText("phone", """<span 
class="glyphicon glyphicon-earphone"></span>""", 
css_class="inputblock-level"), 
bootstrap.PrependedText("email", "@", 
css_class="input-block-level", 
placeholder="contact@example.com"), 
css_id="contact_info", 


), 
) ， 


bootstrap.FormActions( 
layout.Submit('submit', _('Save')), 





要 泻 染 模板 中 的 表单 ， 如 下 ， 我 们 只 需 载 入 标签 冷酷 crispy forms tags ， 然 后 使 用 模板 标 
& {% crispy %} 


ates 


(96 extends "base.html" 96) 
(96 load crispy forms tags 96) 
(96 block content %} 


(96 crispy form %} 
(96 endblock 96) 


工作 原理 


拥有 新 闻 简 报表 的 页 面 的 样子 大 概 如 此 : 
图 片 : 略 


As you see, the fields are grouped by fieldsets. The first argument of the Fieldset object 
defines the legend, the other positional arguments define fields. You can also pass named 
arguments to define HTML attributes for the fieldset; for example, for the second fieldset, we 
are passing title and css id to set the HTML attributes title and id. 


如 你 所 见 ， 字 段 是 由 字段 集合 组 成 的 。 


Fields can also have additional attributes passed by named arguments, for example, for the 
description field, we are passing css class and rows to set the HTML attributes class and 
rows. 


字段 也 可 以 通过 传递 命名 参数 拥有 额外 的 属性 ， 例 如 ， 


Besides the normal fields, you can pass HTML snippets as this is done with the help block 
forthe image field. You can also have prepended-text fields in the layout, for example, we 
added a phone icon to the phone field, and an @ sign for the email field. As you see from 
the example with contact fields, we can easily wrap fields into HTML 


elements using Div objects. This is useful when specific JavaScript needs to be applied to 
some form fields. 


除了 常规 字段 ， 你 可 以 传递 HTML 片 段 


The action attribute for the HTML form is defined by the form action property of the form 
helper. The method attribute of the HTML form is defined by the form method property of 
the form helper. Finally, there is a Submit object to render the submit button, which takes the 
name of the button as the first positional argument, and the value of the button as the 
second argument. 


还 有 更 多 


For the basic usage, the given example is more than necessary. However, if you need 
specific markup for forms in your project, you can still overwrite and modify templates of the 
django-crispy-forms app, as there is no markup hardcoded in Python files, but rather all the 
generated markup is rendered through the templates. Just copy the templates from the 
django-crispy-forms app to your project's template directory and change them as you need. 


为 了 说 明基 本 用 法 ， 给 出 例子 是 很 有 必要 的 一 件 事 。 不 过 ， 加 入 你 需要 在 项 目 中 为 表单 指定 
装饰 ， 你 仍然 可 以 重 SAX django-crispy-forms 这 个 应 用 的 模板 ， 在 Python 文件 中 不 仅 不 
存在 由 装饰 的 硬 编码 。 


HE RI RK 


在 web 开 发 中 ， 除 了 视图 和 表单 ， 拥 有 对 象 列 表 视 图 和 详细 视图 是 很 典型 的 情况 。 列 表 视 图 可 
以 简单 的 排列 对 象 的 顺序 ， 例 如 ， 按 找 首 字母 排序 或 者 创建 日 期 来 调用 ， 不 过 对 于 非常 庞大 
的 数据 来 说 就 不 是 那么 的 友好 了 。 


预备 工作 


For the filtering example, we will use the Movie model with relations to genres, directors, and 
actors to filter by. It will also be possible to filter by ratings, which is PositivelntegerField with 
choices. Let's create the movies app, put it into INSTALLED APPS in the settings 
(movies/models.py), and define the mentioned models in the new app: 


: 了 说 明 过 滤 例子 ， 我 们 会 使 用 关联 了 种 类 、 导 演 与 演员 的 Moive 模 型 进行 过 滤 。 而 且 通 过 评 

过 滤 也 是 可 以 的 ， 这 是 一 个 含有 PositivelntegerField 的 多 选 列表 。 我 们 来 创建 应 用 
movies， 并 将 它 放 到 设置 文件 中 的 INSTALLED_APPS， 然 后 在 这 个 新 应 用 中 定义 前 面 提 及 的 
模型 : 


#movies/models.py 

# -*- coding: UTF-8 -*- 

from django.db import models 

from django.utils.translation import ugettext_lazy as _ 


RATING_CHOICES = ( 
(1, 
(2, 
(3, 
(4, 
(5, 





) 


class Genre(models.Model): 
title = models.CharField( ("Title"), max length-1606) 


def unicode. (self): 
return self.title 


class Director(models.Model): 
first name = models.CharField( ("First name"), max length-46) 
last name = models.CharField( ("Last name"), max length-40) 


def unicode (self): 
return self.first name + " " + self.last name 


class Actor(models.Model): 
first name = models.CharField( ("First name"), max length-46) 
last name = models.CharField( ("Last name"), max length-40) 


def unicode (self): 
return self.first name + " " + self.last name 


class Movie(models.Model): 
title - models.CharField( ("Title"), max length-255) 
genres = models.ManyToManyField(Genre, blank=True) 
directors = models.ManyToManyField(Director, blank=True) 
actors = models.ManyToManyField(Actor, blank=True) 
rating = models.PositiveIntegerField(choices=RATING_CHOICES) 


def unicode. (self): 
return self.title 


具体 做 法 


首先 ， 我 们 创建 能 够 尽 可 能 过 滤 所 有 目录 的 MovieFilterForm 


#movies/forms.py 
oding: UTF-8 


from django import forms 
from django.utils.translation import ugettext_lazy as _ 





CC 


from models import Genre 

from models import Director 

from models import Actor 

from models import RATING_CHOICES 


class MovieFilterForm(forms.Form): 

genre = forms.ModelChoiceField( 
label- ("Genre"), 
required=False, 
queryset=Genre.objects.all(), 

) 

director = forms.ModelChoiceField( 
label=_("Director"), 
required=False, 
queryset=Director.objects.all(), 
) 

actor = forms.ModelChoiceField( 
label=_("Actor"), 
required=False, 
queryset=Actor.objects.all(), 

) 

rating = forms.ChoiceField( 
label=_("Rating"), 
required=False, 
choices=RATING_CHOICES, 


Then, we create a movie_list view that will use MovieFilterForm to validate the request 
query parameters and do the filtering by chosen categories. Note the facets dictionary, which 
is used here to list the categories and also the currently selected choices: 


所 选择 的 种 类 进行 过 滤 。 要 注意 字典 这 一 方面 ， 这 里 改 字典 用 来 列 出 目录 以 及 当前 选 定 的 选 
项 


#movies/views.py 

# -*- coding: UTF-8 -*- 

from django.shortcuts import render 

from models import Genre 

from models import Director 

from models import Actor 

from models import Movie, RATING_CHOICES 
from forms import MovieFilterForm 


def movie_list(request): 
qs = Movie.objects.order by('title') 
form = MovieFilterForm(data=request .REQUEST ) 


facets = { 
"selected n}, 
'categories': { 
'genres': Genre.objects.all(), 
'directors': Director.objects.all(), 
'actors': Actor.objects.all(), 
'ratings': RATING CHOICES, 
u 
} 


if form.is valid(): 
genre - form.cleaned data['genre'] 
if genre: 
facets['selected']['genre'] - genre 
qs = qs.filter(genres-genre).distinct() 


director - form.cleaned data['director'] 
if director: 
facets['selected']['director'] - director 
qs = qs.filter(directors=director).distinct() 
actor = form.cleaned data['actor'] 
if actor: 
facets['selected']['actor'] = actor 
qs = qs.filter(actors=actor).distinct() 


rating = form.cleaned data['rating'] 
if rating: 
facets['selected']['rating'] = (int(rating), dict(RATING_CHOICES) [int(rating) 
qs = qs.filter(rating=rating) .distinct() 
context = { 
'form': form, 
'facets': facets, 
'object list': qs, 
} 


return render(request, "movies/movie list.html", context) 
E ————— -——— -— ————À! € 2& LM SÍ Í— 


Lastly, we create the template for the list view. We will use the facets dictionary here to list 
the categories and to know which category is currently selected. To generate URLs for the 
filters, we will use the {% append to query %} template tag, which will be described later in 
the Creating a template tag to modify request query parameters recipe in Chapter 5, Custom 
Template Filters and Tags. Copy the following code in the templates/movies/movie list.html 





directory: 


最 后 ， 我 们 为 列表 视图 创建 模板 。 我 们 会 使 用 


{#termplates/movies/movie_list.html} 
{% extends "base two columns.html" %} 
(96 load i18n utility tags %} 


(96 block sidebar %} 
«div class="filters"> 
<h6>{% trans "Filter by Genre" %}</h6> 
«div class="list-group"> 
«a class="list-group-item{% if not facets.selected.genre %} active{% endif %}" hr 
{% for cat in facets.categories.genres %} 
«a class="list-group-item{% if facets.selected.genre == cat %} active{% endif 
{% endfor %} 
</div> 


<h6>{% trans "Filter by Director" %}</h6> 
<div class="list-group"> 
<a class="list-group-item{% if not facets.selected.director %} active{% endif %}" 
href="{% append to query director="" page="" %}">{% trans "All" %}</a> 
{% for cat in facets.categories.directors %} 
<a class="list-group-item{% if facets.selected.director == cat %} active{% en 
{% endfor %} 
</div> 


<h6>{% trans "Filter by Actor" %}</h6> 
<div class="list-group"> 
<a class="list-group-item{% if not facets.selected.actor %} active{% endif %}" hr 
{% for cat in facets.categories.actors %} 
«a class="list-group-item{% if facets.selected.actor == cat %} active{% endif 
{% endfor %} 
</div> 


<h6>{% trans "Filter by Rating" %}</h6> 
<div class="list-group"> 
<a class="list-group-item{% if not facets.selected.rating %} active{% endif %}" h 
{% for r_val, r_display in facets.categories.ratings %} 
«a class="list-group-item{% if facets.selected.rating.O == r val %} active{% 
(96 endfor 96) 
«/div» 
«/div» 
(96 endblock 96) 


(96 block content %} 
«div class="movie_list"> 
(96 for movie in object list %} 
«div class="movie"> 
<h3>{{ movie.title }}</h3> 
</div> 
{% endfor %} 
</div> 
{% endblock %} 


EJE) 





工作 原理 


If we use the Bootstrap 3 frontend framework, the end result will look like this in the browser 
with some filters applied: 


图 片 : % 


So, we are using the facets dictionary that is passed to the template context, to know what 
filters we have and which filters are selected. To look deeper, the facets dictionary consists 
of two sections: the categories dictionary and the selected dictionary. The categories 


dictionary contains the QuerySets or choices of all filterable categories. The selected 
dictionary contains the currently selected values for each category. 


In the view, we check if the query parameters are valid in the form and then we drill down the 
QuerySet of objects by the selected categories. Additionally, we set the selected values to 
the facets dictionary, which will be passed to the template. 


In the template, for each categorization from the facets dictionary, we list all categories and 
mark the currently selected category as active. 


It is as simple as that. 


参阅 


The Managing paginated lists recipe 
The Composing class-based views recipe 


The Creating a template tag to modify request query parameters recipe in Chapter 5, 
Custom Template Filters and Tags 


管理 分 页 列表 


fyou have dynamically changing lists of objects or when the amount of them can be greater 
than 30-50, you surely need pagination for the list. With pagination instead of the full 
QuerySet, you provide a fraction of the dataset limited to a specific amount per page and 
you also show the links to get to the other pages of the list. Django has classes to manage 
paginated data, and in this recipe, | will show you how to do that for the example from the 
previous recipe. 


TR 28 


NASN 


Let's start with the movies app and the forms as well as the views from the Filtering object 
lists recipe. 


具体 做 法 


At first, import the necessary pagination classes from Django. We will add pagination 
management to the movie list view just after filtering. Also, we will slightly modify the 
context dictionary by passing a page instead of the movie QuerySet as object list : 


首先 ， 从 Django 导 入 必需 的 分 页 类 。 我 们 会 在 过 滤 之 后 将 分 页 管理 添加 到 movie list ° 而 
且 ， 我 们 也 要 传递 一 个 页 面 而 不 是 movie 的 查询 集合 object list 来 稍微 修改 上 下 文字 典 。 


4movies/views.py 

4 -*- coding: UTF-8 -*- 

from django.shortcuts import render 

from django.core.paginator import Paginator, EmptyPage, \ 
PageNotAnInteger 


from models import Movie 
from forms import MovieFilterForm 


def movie list(request): 
qs - Movie.objects.order by('title') 
# ... filtering goes here... 


paginator = Paginator(qs, 15) 


page number = request.GET.get('page') 
ERY: 
page = paginator.page(page number) 
except PageNotAnInteger: 
4 If page is not an integer, show first page. 
page = paginator .page(1) 
except EmptyPage: 
# If page is out of range, show last existing page. 
page = paginator.page(paginator.num_pages) 


context = { 
'form': form, 
'object list': page, 
} 


return render(request, "movies/movie list.html", context) 


In the template, we will add pagination controls after the list of movies as follows: 


{#templates/movies/movie_list.html#} 
{% extends "base.html" %} 
{% load i18n utility tags %} 


{% block sidebar %} 


fue 


filters go here... #} 


(96 endblock 96) 


(96 block content %} 
«div class="movie_list"> 
(96 for movie in object list %} 


«div class-"movie alert alert-info"» 


<p>{{ movie.title }}</p> 


</div> 


{% endfor %} 


</div> 


{% if object_list.has_other_pages %} 
<ul class="pagination"> 


{% if object_list.has_previous %} 
<li><a href="{% append_to_query page=object_list.previous_page_number %}">&la 
{% else %} 
«li class="disabled"><span>&laquo;</span></1i> 
{% endif %} 
{% for page_number in object_list.paginator.page_range %} 
{% if page_number == object_list.number %} 
<li class="active"> 
<span>{{ page number }} «span class="sr-only">(current )</span></span> 
</li> 
{% else %} 
<li> 
<a href="{% append_to_query page=page_number %}">{{ page_number }}</a 
</li> 
{% endif %} 
{% endfor %} 
{% if object_list.has_next %} 
<li><a href="{% append_to_query page=object_list.next_page_number %}">&raquo; 
{% else %} 
«li class="disabled"><span>&raquo; </span></1i> 
{% endif %} 


</ul> 
{% endif %} 


{% endblock %} 


E = ; 





工作 原理 


图 片 : 略 


When you look at the results in the browser, you will see pagination controls like these, 
added after the list of movies: 


How do we achieve that? When the QuerySet is filtered out, we create a paginator object 


passing the QuerySet and the maximal amount of items we want to show per page (which is 


15 here). Then, we read the current page number from the query parameter, page. The next 


step is retrieving the current page object from the paginator. If the page number was not an 
integer, we get the first page. If the number exceeds the amount of possible pages, the last 


page is retrieved. The page object has methods and attributes necessary for the pagination 
widget shown in the preceding screenshot. Also, the page object acts like a QuerySet, so 
that we can iterate through it and get the items from the fraction of the page. 


The snippet marked in the template creates a pagination widget with the markup for the 
Bootstrap 3 frontend framework. We show the pagination controls only if there are more 
pages than the current one. We have the links to the previous and next pages, and the list of 
all page numbers in the widget. The current page number is marked as active. To generate 
URLs for the links, we are using the template tag {% append to query 96), which will be 
described later in the Creating a template tag to modify request query parameters recipe in 
Chapter 5, Custom Template Filters and Tags. 


参阅 


The Filtering object lists recipe 

The Composing class-based views recipe 

The Creating a template tag to modify request query parameters recipe in Chapter 5, 
Custom Template Filters and Tags 


编写 类 视图 


Django views are callables that take requests and return responses. In addition to function- 
based views, Django provides an alternative way to define views as classes. This approach 
is useful when you want to create reusable modular views or when you want to combine 
views out of generic mixins. In this recipe, we will convert the previously shown function- 
based view, movie list, into a class-based view, MovieListView. 


TR # 


Create the models, the form, and the template like in the previous recipes, Filtering object 
lists and Managing paginated lists. 


具体 做 法 


We will need to create a URL rule in the URL configuration and add a class-based view. To 
include a class-based view in the URL rules, the as view()method is used like this: 


#mov 
# - 
From 
From 


urlp 


) 


ies/urls.py 


*- coding: UTF-8 -*- 


django.conf.urls import patterns, url 

views import MovieListView 

atterns - patterns('', 

url(r'^$', MovieListView.as_view(), name-"movie list"), 


Our class-based view, MovieListView, will overwrite the get and post methods of the View 


class, 


which are used to distinguish between requests by GET and POST. We will also add 


the get queryset and facets and get page methods to make the class more modular: 


mov 
E nw 
from 
from 


from 


from 
from 
from 
from 
from 


clas 


ies/views.py 

- coding: UTF-8 -*- 

django.shortcuts import render 
django.core.paginator import Paginator, EmptyPage, \ 
PageNotAnInteger 

django.views.generic import View 


models import Genre 

models import Director 

models import Actor 

models import Movie, RATING CHOICES 
forms import MovieFilterForm 


s MovieListView(View): 

form class - MovieFilterForm 

template name = 'movies/movie list.html' 
paginate by - 15 


def get(self, request, *args, **kwargs): 
form = self.form class(data-request.REQUEST) 
qs, facets - self.get queryset and facets(form) 
page - self.get page(request, qs) 
context = { 
'form': form, 
'facets': facets, 
'object list': page, 
} 


return render(request, self.template name, context) 


def post(self, request, *args, **kwargs): 
return self.get(request, *args, **kwargs) 


def get queryset and facets(self, form): 
qs - Movie.objects.order by('title') 


facets = { 
'selected': {}, 
"categories': { 
'genres': Genre.objects.all(), 
'directors': Director.objects.all(), 
'actors': Actor.objects.all(), 
'ratings': RATING CHOICES, 


i 
} 


if form.is valid(): 
genre - form.cleaned data['genre'] 
if genre: 
facets['selected']['genre'] - genre 
qs = qs.filter(genres=genre).distinct() 


director = form.cleaned data['director'] 
if director: 
facets['selected']['director'] = director 
qs = qs.filter(directors=director).distinct() 


actor - form.cleaned data['actor'] 
if actor: 
facets['selected']['actor'] - actor 
qs - qs.filter(actors-actor).distinct() 


rating - form.cleaned data['rating'] 
if rating: 
facets['selected']['rating'] - (int(rating), 
dict(RATING CHOICES)[int(rating)]) 
qs = gs.filter(rating-rating).distinct() 
return qs, facets 


def get page(self, request, qs): 
paginator - Paginator(qs, self.paginate by) 


page number = request.GET.get('page') 
(EIS AB 
page - paginator.page(page number) 
except PageNotAnInteger: 
page = paginator.page(i) _ ails l 
except EmptyPage: 


exis a page 


ge 


ginator.num pages) 


page - paginator.page(pa 
return page 


工作 原理 


No matter whether the request was called by the GET or POST methods, we want the view 
to act the same; so, the post method is just calling the get method in this view, passing all 
positional and named arguments. 


These are the things happening in the get method: 


At first, we create the form object passing the REQUEST dictionary-like object to it. The 
Then, the form is passed to the get queryset and facets method, which respectively return 
Then, the current request object and the QuerySet is passed to the get page method, which 


Lastly, we create a context dictionary and render the response. 


IE 


还 有 更 多 


As you see, the get, post, and get page methods are quite generic, so that we could create 





a generic class, FilterableListView, with those methods in the utils app. Then in any app, 
which needs a filterable list, we could create a view that extends FilterableListView and 
defines only the form class and template name attributes and the get queryset and facets 
method. This is how class-based views work. 


参阅 


The Filtering object lists recipe 
The Managing paginated lists recipe 


生成 PDF 文 档 


Django views allow you to create much more than just HTML pages. You can generate files 
of any type. For example, you can create PDF documents for invoices, tickets, booking 
confirmations, or some other purposes. In this recipe, we will show you how to generate 
resumes (curriculum vitae) in PDF format out of the data from the database. We will be 
using the Pisa xhtml2pdf library, which is very practical as it allows you to use HTML 
templates to make PDF documents. 


预 热 
First of all, we need to install the Python libraries reportlab and xhtml2pdf in your virtual 
environment: 


(myproject env)$ pip install reportlab--2.4 
(myproject env)$ pip install xhtml2pdf 


Then, let us create a cv app with a simple CV model with the Experience model attached to 
it through a foreign key. The CV model will have these fields: first name, last name, and e- 
mail. The Experience model will have these fields: the start date at a job, the end date at a 
job, company, position at that company, and skills gained: 


#cv/models.py 

# -*- coding: UTF-8 -*- 

from django.db import models 

from django.utils.translation import ugettext_lazy as _ 


class CV(models.Model): 
first name = models.CharField( ("First name"), max_length=40) 
last name = models.CharField( ("Last name"), max length-40) 
email - models.EmailField( ("Email")) 


def unicode (self): 
return self.first name + " " + self.last name 


class Experience(models.Model): 
cv = models.ForeignKey(CV) 
from date = models.DateField( ("From")) 
till date = models.DateField( ("Till"), null=True, blank=True) 
company = models.CharField( ("Company"), max length-100) 
position = models.CharField( ("Position"), max length-106) 
skills = models.TextField( ("Skills gained"), blank=True) 


def unicode (self): 

till = ("present") 

if self.till_date: 
till = self.till_date.strftime( '%m/%yY' ) 

return _("%(from)s-%(till)s %(position)s at %(company)s") % { 
'from': self.from_date.strftime('%m/%Y'), 
'till': till, 'position': self.position, 
'company': self.company, 


j 


class Meta: 
ordering - ("-from date",) 


工作 原理 


In the URL rules, let us create a rule for the view to download a PDF document of a resume 
by the ID of the CV model, as follows: 


#cv/urls.py 
# -*- coding: UTF-8 -*- 
from django.conf.urls import patterns, url 


urlpatterns = patterns('cv.views', 


url(r'4(?P<cv_id>\d+)/pdf/$', 'download cv pdf', 
name-'download cv pdf'), 


Now let us create the download cv pdf view. This view renders an HTML template and then 
passes it to the PDF creator pisaDocument: 


#cv/views.py 
# -*- coding: UTF-8 -*- 
Ery: 

from cStringIO import StringIO 
except ImportError: 

from StringIO import StringIO 
from xhtml2pdf import pisa 


from django.conf import settings 

from django.shortcuts import get object or 404 

from django.template.loader import render to string 
from django.http import HttpResponse 





from cv.models import CV 


def download cv pdf(request, cv id): 
cv = get object or 404(CV, pk-cv id) 


response = HttpResponse(mimetype-'application/pdf') 
response['Content-Disposition'] = 'attachment; ' \ 
'filename=%s_%s.pdf' 96 (cv.first name, cv.last name) 


html = render to string("cv/cv pdf.html", { 
"CV CV, 
'MEDIA ROOT': settings.MEDIA ROOT, 
'STATIC ROOT': settings.STATIC ROOT, 


23 


pdf = pisa.pisaDocument( 
StringIO(html.encode("UTF-8")), 
response, 
encoding-'UTF-8', 

) 


return response 


At last, we create the template by which the document will be rendered, as follows: 


{#templates/cv/cv_pdf .html#} 
<!DOCTYPE HTML> 


<html> 
<head> 
<meta charset="utf-8" /> 
<title>My Title</title> 
<style type="text/css"> 
@page { 
size: "A4"; 
margin: 2.5cm 1.5cm 2.5cm 1.5cm; 
@frame footer { 
-pdf-frame-content: footerContent; 
bottom: Ocm; 
margin-left: Ocm; 
margin-right: Ocm; 
height: 1cm; 
} 
} 
#footerContent { 
color: #666; 
font-size: 10pt; 
text-align: center; 
} 
/* ... Other CSS Rules go here ... */ 
</style> 
</head> 
<body> 
<div> 


«p class="hi">Curriculum Vitae</p> 
<table> 


«tr» 
<td><p><b>{{ cv.first name jj {{ cv.last name }}</b><br /> 
Contact: {{ cv.email }}</p> 
</td> 
<td align="right"> 
<img src="{{ STATIC_ROOT }}/site/img/smiley.jpg" width="100" heig 
</td> 
</tr> 
</table> 


<p class="h2">Experience</p> 


<table> 
{% for experience in cv.experience_set.all %} 
<tr> 
<td><p>{{ experience.from_date|date:"F Y" }} - 
{% if experience.till_date %} 
{{ experience.till_date|date:"F Y" }} 
{% else %} 
present 
{% endif %}<br /> 
{{ experience.position }} at {{ experience.company }}</p> 
</td> 
<td><p><b>Skills gained</b><br> 
{{ experience.skills|linebreaksbr }} 
<br> 
<br> 
</p> 
</td> 
</tr> 
{% endfor %} 
</table> 
</div> 
«pdf :nextpage> 
<div> 
This is an empty page to make a paper plane. 
</div> 


<div id="footerContent"> 
Document generated at {% now "Y-m-d" %} | 
Page <pdf:pagenumber> of <pdf:pagecount> 
</div> 
</body> 
</html> 


4 — 3 





工作 原理 


Depending on the data entered into the database, the rendered PDF document might look 
like this: 


图 片 : 略 


How does the view work? At first, we load a curriculum vitae by its ID if it exists, or raise the 
Page-not-found error if it does not. Then, we create the response object with mimetype of 
the PDF document. We set the Content-Disposition header to attachment with the specified 
filename. This will force browsers to open a dialog box prompting to save the PDF document 
and will suggest the specified name for the file. Then, we render the HTML template as a 
string passing curriculum vitae object, and the MEDIA ROOT and STATIC_ROOT paths. 


> that the src attribute of the tag used for PDF creation needs to point to the file in 





system or the full URL of the image online. 


Then, we create a pisaDocument file with the UTF-8 encoded HTML as source, and 
response object as the destination. The response object is a file-like object, and 
pisaDocument writes the content of the document to it. The response object is returned by 
the view as expected. 


Let us have a look at the HTML template used to create this document. The template has 
some unusual HTML tags and CSS rules. If we want to have some elements on each page 
of the document, we can create CSS frames for that. In the preceding example, the 


tag with the footerContent ID is marked as a frame, which will be repeated at the bottom of 
each page. In a similar way, we can have a header or a background image for each page. 


Here are the specific HTML tags used in this document: 


The «pdf:nextpage» tag sets a manual page break 
The «pdf:pagenumber» tag returns the number of the current page 
The «pdf:pagecount» tag returns the total number of pages 


The current version 3.0.33 of the Pisa xhtml2pdf library does not fully support all HTML tags 
and CSS rules; for example, 


, and other headings are broken and there is no 
concept of floating, so instead you have to use 
paragraphs with CSS classes for different font 
styles and tables for multi-column layouts. 
However, this library is still mighty enough for 
customized layouts, which basically can be 
created just with the knowledge of HTML and CSS. 


参阅 


The Managing paginated lists recipe 


Django 网 站 开发 Cookbook 


第 三 章 表单 与 视图 .md 
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第 四 章 -模板 和 JavaScript 


本 章 ， 我 们 讨论 到 以 下 话题 : 


整理 base .html 模 板 
包含 JavaScript 设 置 
使 用 HTML5 数 据 属性 
在 弹 窗 中 显示 对 象 细节 
实现 不 间断 滚动 
实现 Like 部 件 


使 用 Ajax 上 传 图 片 


引言 


我 们 生活 在 

整理 base.html 模 板 
提示 

预 热 


具体 做 法 


执行 以 下 步骤 : 


1. 在 模板 的 根 目 录 中 使 用 下 列 内 容 创 建 一 个 base.html 文件 : 


{#templates/base.htm1#} 

{% block doctype %}<!DOCTYPE html>{% endblock %} 
{% load i18n %} 

«html lang="{{ LANGUAGE CODE }}"> 

«head» 


«meta charset-"utf-8" /» 

«meta name-"viewport" content="width=device-width, initial-scale-1" /> 
<title>{% block title %}{% endblock %}{% trans "My Website" %}</title> 

«link rel="icon" href="{{ STATIC URL }}site/img/favicon.ico" type="image/png" /> 


{% block meta_tags %}{% endblock %} 


<link rel="stylesheet" href="http://netdna.bootstrapcdn.com/bootstrap/3.1.1/css/boots 
^ «link href="{{ STATIC URL }}site/css/style.css" rel="stylesheet" media="screen" typ 


(96 block stylesheet %}{% endblock %} 

«script srcz'http://code.jquery.com/jquery-1.11.0.min.js"»«/script» 

«script src="http://code. jquery.com/jquery-migrate-1.2.1.min.js"></script> 

«script src="http://netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js"></sc 
<script src="{% url "js_settings" %}"></script> 

{% block js %}{% endblock %} 

{% block extrahead %}{% endblock %} 


</head> 
<body class="{% block bodyclass %}{% endblock %}"> 


{% block page %} 
<div class="wrapper"> 
<div id="header" class="clearfix"> 
<hi>{% trans "My Website" %}</h1> 
{% block header_navigation %} 
{% include "utils/header_navigation. html" %} 
{% endblock %} 
{% block language_chooser %} 
{% include "utils/language chooser.html" %} 
{% endblock %} 
</div> 
<div id="content" class="clearfix"> 
{% block content %} 
{% endblock %} 
</div> 
<div id="footer" class="clearfix"> 
{% block footer_navigation %} 
{% include "utils/footer_navigation. html" %} 
{% endblock %} 
</div> 
</div> 
{% endblock %} 
{% block extrabody %}{% endblock %} 


</body> 
</html> 





1. 在 相同 的 目录 中 ， 针 对 特定 的 情况 创建 另外 一 个 命名 为 base simple.html 


{% 


templates/base simple.html #} 
extends "base.html" 96) 


block page %} 
«div class="wrapper'"> 
«div id="content" class="clearfix"> 
{% block content %} 
{% endblock %} 
</div> 
</div> 
endblock %} 


具体 做 法 


加 入 JavaScript 的 设置 


PAE 定制 模板 过 滤器 和 标签 
本 章 ， 我 们 会 学 习 以 下 内 容 : 


遵循 模板 过 滤器 和 标签 的 约定 
e 创建 一 个 模板 过 滤器 显示 已 经 过 去 的 天 数 
e Mc e EE T CUN E 


e uA CDI ER cuius 
e 创建 一 个 模板 标签 为 模板 解析 内 容 
e 创建 一 个 模板 标签 修改 request 查 询 参 数 





简介 


如 你 所 知 ，Django 有 一 个 非常 庞大 的 模板 系统 ， 特 别 是 模板 继承 ， 


遵循 模板 过 滤器 和 标签 的 约定 


Custom template filters and tags can become a total mess if you don't have persistent 
guidelines to follow. Template filters and tags should serve template editors as much as 
possible. They should be both handy and flexible. In this recipe, we will look at some 
conventions that should be used when enhancing the functionality of the Django template 


system. 


滤器 和 标签 时 会 让 你 完全 不 知 所 措 。 模 板 过 滤器 和 标 oe 
且 它 们 都 应 该 同时 具有 操作 方便 和 灵活 扩展 的 特性 。 在 这 个 做 法 中 ， 我 们 会 见 到 一 些 在 增强 
Django 模 板 系 统 功 能 时 所 用 到 的 几 点 约定 。 


如 何 做 


扩张 Django 模 板 系统 时 遵循 以 下 约定 : 


1. 当 在 视图 ， 上 下 文 处 理 器 ， 或 者 模型 方法 中 ， 页 面 更 适合 逻辑 时 ， 不 要 创建 或 者 使 用 定制 模板 过 滤器 、 标 签 。 你 的 页 中 
2. 使 用 _tags 后 缓 命名 模板 标签 库 。 当 你 的 app 命 名 不 同 于 模板 标签 库 时 ， 你 可 以 避免 模糊 的 包 导 入 问题 。 

3. 例如 ， 通 过 使 用 如 下 注释 ， 在 最 后 创建 的 库 中 ， 从 标签 中 分 离 过 滤器 : 

# -*- coding: UTF-8 -*- 

from django import template 

register - template.Library() 

### FILTERS ### 


# .. your filters go here .. 


#H## TAGS ### 
4 .. your tags go here.. 


4. 通过 下 面 的 格式 ， 创 建 的 模板 标签 就 可 以 被 轻松 记 住 : 
for [app name.model name]: 使 用 该 格式 以 使 用 指定 的 模型 
using [template_name] : 使 用 该 格式 将 一 个 模板 的 模板 标签 输出 
limit [count] :使 用 该 格式 将 结果 限制 为 一 个 指定 的 数量 
as [context variable]: 使 用 该 结构 可 以 将 结构 保存 到 一 个 在 之 后 多 次 使 用 的 上 下 文 变量 
5. 要 尽量 避免 在 模板 标签 中 按 位 置地 定义 多 个 值 除非 它们 都 是 不 解 自明 的 。 和 否则 ， 这 会 有 可 能 使 开发 者 迷惑 。 


6. 尽 可 能 的 使 用 更 多 的 可 理解 的 参数 。 没 有 引号 的 字符 串 应 该 当 作 需要 解析 的 上 下 文 变量 或 者 可 以 提醒 你 关于 模板 标签 








The Creating a template filter to show how many days have passed recipe The Creating a 
template filter to extract the first media object recipe The Creating a template filter to 
humanize URLs recipe The Creating a template tag to include a template if it exists recipe 
The Creating a template tag to load a QuerySet in a template recipe The Creating a 
template tag to parse content as a template recipe The Creating a template tag to modify 
request query parameters recipe" 


创建 一 个 模板 过 滤器 显示 已 经 过 去 的 天 数 


Not all people keep track of the date, and when talking about creation or modification dates 
of cutting-edge information, for many of us, it is more convenient to read the time difference, 
for example, the blog entry was posted three days ago, the news article was published 
today, and the user last logged in yesterday. In this recipe, we will create a template filter 
named days_since that converts dates to humanized time differences. 


不 是 所 有 的 人 都 持续 关注 时 间 ， 而 且 在 谈论 最 新 日 期 信息 的 新 建 和 修改 时 ， 对 于 我 们 大 多 数 
人 来 说 读 取 时 间 差 是 更 为 合适 的 一 种 选择 ， 例 如 ， 博 客 内 容 在 发 布 于 三 天 之 前 ， 新 的 文章 在 
今天 发 布 了 ， 而 用 户 则 是 在 昨天 进行 了 最 后 的 登陆 行为 。 在 这 个 做 法 中 ， 我 们 将 新 一 个 称 作 
days_since 的 可 以 转换 日 期 到 人 类 可 读 时 间 差 的 模板 过 滤器 。 


准备 开始 


Create the utils app and put it under INSTALLED APPS in the settings, if you haven't done that 
yet. Then, create a Python package named templatetags inside this app (Python packages 
are directories with an empty _ init__.py file). 

创建 utils 应 用 并 将 它 放 到 settings 文 件 中 的 iNsrALLED APPS 下 ， 要 是 你 还 没有 按照 我 说 的 去 做 
的 话 。 然 后 ， 在 这 个 应 用 里 边 创 建 一 个 名 叫 templatetags 的 Python 文 件 夹 (Python 包 是 一 个 
拥有 内 容 为 空 的 ”init .py 文件 ) 。 


我 该 怎么 做 
使 用 下 面 的 内 容 创建 一 个 utility_tags.py 文 件 : 


#utils/templatetags/utility_tags.py 
H coding Une Se 
from datetime import datetime 


from django import template 

from django.utils.translation import ugettext_lazy as _ 
from django.utils.timezone import now as tz_now 
register = template.Library() 


HHR FILTERS ### 


Qregister.filter 
def days since(value): 
""" Returns number of days between today and value.""" 


today - tz now().date() 

if isinstance(value, datetime.datetime): 
value - value.date() 

diff = today - value 

if diff.days » 1: 
return _("%s days ago") % diff.days 

elif diff.days -- 1: 
netunnemssyestenday») 

elif diff.days == 0: 
return _("today") 

elise: 
+ Date is in the future; return formatted date. 
return value.strftime("%B %d, %Y") 


工作 原理 


If you use this filter in a template like the following, it will render something like yesterday or 
5 days ago: 


假如 你 在 模板 中 使 用 了 如 下 所 示 的 过 滤器 ， 那 么 该 过 滤 
五 天 前 : 
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"(96 load utility tags %} 
{{ object.created|days since }} 
You can apply this filter to the values of the date and datetime types. 


Each template-tag library has a register where filters and tags are collected. Django filters 
are functions registered by the register.filter decorator. By default, the filter in the 
template system will be named the same as the function or the other callable object. If you 
want, you can set a different name for the filter by passing name to the decorator, as follows: 


每 个 模板 标签 库 都 有 一 个 收集 过 滤器 和 标签 的 注册 器 。Django 过 滤器 是 通过 装饰 

pa register.filter 注册 过 的 函数 。 上 默认 ， 模 板 系 统 中 的 过 滤器 的 名 称 和 部 3 数 或 者 其 他 可 调用 
对 象 的 名 称 相同 。 如 下 ， 如 果 你 有 需要 的 话 ， 你 可 以 通过 传递 名 称 到 装饰 器 来 为 过 滤器 设置 
一 个 不 同 的 名 称 : 


Qregister.filter(name-"humanized days since") 
def days since(value): 


The filter itself is quite self-explanatory. At first, the current date is read. If the given value of 
the filter is of the datetime type, the date is extracted. Then, the difference between today 
and the extracted value is calculated. Depending on the number of days, different string 
results are returned. 


还 有 更 多 


This filter is easy to extend to also show the difference in time, such as just now, 7 minutes 
ago, or 3 hours ago. Just operate the datetime values instead of the date values. 


参阅 


The Creating a template filter to extract the first media object recipe 
The Creating a template filter to humanize URLs recipe 


€) E — NAR Mc IB BS VAG a — AGE SR 


Imagine that you are developing a blog overview page, and for each post, you want to show 
images, music, or videos in that page taken from the content. In such a case, you need to 
extract the <img>, «object» , and <embed> tags out of the HTML content of the post. In 
this recipe, we will see how to do this using regular expressions in the get first media 
filter. 


准备 开始 吧 


We will start with the utils app that should be set in _ INSTALLED_APPS in the settings and the 
templatetags package inside this app. 


如 何 做 


In the utility tags.py file, add the following content: 
在 utility tags.py 文件 中 ， 添 加 以 下 内 容 : 





Import re 
from django import template 

from django.utils.safestring import mark safe 
register - template.Library() 


FILTERS 


media file regex = re.compile(r"«object .+?</object>|" 
r"«(img|embed) [^2]*2") ) 
Qregister.filter 
def get first media(content): 
""" Returns the first image or flash file from the html content """ 
m = media file regex.search(content) 
media tag = "" 
if m: 
media tag - m.group() 
return mark safe(media tag) 


工作 原理 


While the HTML content in the database is valid, when you put the following code in the 
template, it will retrieve the «object» , «img» , Or <embed> tags from the content field of the 
object, or an empty string if no media is found there: 


{% load utility tags %} 
{{ object.content|get first media }} 


At first, we define the compiled regular expression as media file regex , then in the filter, 
we perform a search for that regular expression pattern. By default, the result will show the 
<, >, and & symbols escaped as alt; , &gt; , and &amp ; entities. But we use the 

mark safe function that marks the result as safe HTML ready to be shown in the template 
without escaping. 


还 有 更 多 


It is very easy to extend this filter to also extract the «iframe» tags (which are more recently 
being used by Vimeo and YouTube for embedded videos) or the HTML5 «audio» and 
«video» tags. Just modify the regular expression like this: 


media file regex = re.compile(r"<iframe .+?</iframe>|" 
r"«audio .+?</ audio>|<video .+?</video>|" 
r"«object .+?</object>|<(img|embed) [4>]+>") ” 


The Creating a template filter to show how many days have passed recipe 


The Creating a template filter to humanize URLs recipe 


创建 模板 过 滤器 以 人 性 化 URL 


Usually, common web users enter URLs into address fields without protocol and trailing 
slashes. In this recipe, we will create a humanize url filter used to present URLs to the user 
in a shorter format, truncating very long addresses, just like what Twitter does with the links 
in tweets. 


准备 开始 


As in the previous recipes, we will start with the utils app that should be set in 
INSTALLED APPS in the settings, and should contain the templatetags package. 


就 像 之 前 技巧 中 提 到 的 ， 我 们 会 从 设置 于 INSTALLED APPS 中 的 utils 应 用 开始 ， 它 应 该 包含 


=A templatetags & o 


如 何 做 


In the FILTERS section of the utility tags.py template library in the utils app, let's add a filter 
named humanize url and register it: 


s/templatetags/utility tag: 
import re 


from django import template 
register - template.Library() 


Qregister.filter 
def humanize url(url, letter count): 
""" Returns a shortened human-readable URL """ 
letter count - int(letter count) 
re start - re.compile(r"^https?://") 
re end = re.compile(r"/$") 
url = re end.sub("", re start.sub("", url)) 
if len(url) » letter count: 
url = u"%s..." 96 url[:letter count - 1] 
return url 


工作 原理 


We can use the humanize url filter in any template like this: 


{% load utility tags %} 

«a href="{{ object.website }}" target="_blank"> 
{{ object.website|humanize url:30 }} 

</a> 


The filter uses regular expressions to remove the leading protocol and the trailing slash, and 
then shortens the URL to the given amount of letters, adding an ellipsis to the end if the URL 
doesn't fit into the specified letter count. 


参见 


The Creating a template filter to show how many days have passed recipe 
The Creating a template filter to extract the first media object recipe 
The Creating a template tag to include a template if it exists recipe 


如 果 存 在 一 个 模板 ， 创 建 一 个 模板 标签 以 包含 它 


Django has the {% include %} template tag that renders and includes another template. 
However, in some particular situations, there is a problem that an error is raised if the 
template does not exist. In this recipe, we will show you how to create a 

{% try_to_include %} template tag that includes another template, but fails silently if there 
is no such template. 


准备 开始 


We will start again with the utils app that should be installed and is ready for custom 
template tags. 


如 何 做 


Template tags consist of two things: the function parsing the arguments of the template tag 
and the node class that is responsible for the logic of the template tag as well as for the 
output. Perform the following steps: 


模板 标签 由 两 个 东西 组 成 : 解析 模板 标签 参数 对 函数 ， 以 及 能 够 良好 输出 的 响应 模板 标签 逻 
辑 的 节点 类 。 记 下 来 执行 以 下 步骤 : 


1. First, let's create the function parsing the template-tag arguments: 
首先 ， 让 我 们 来 创建 解析 模板 标签 参数 的 函数 : 


Zutils/templatetags/utility tags.py 

# -*- coding: UTF-8 -*- 

from django import template 

from django.template.loader import get template 
register - template.Library() 


### TAGS ### 


@register.tag 
def try_to_include(parser, token): 
"""Usage: {% try to include "sometemplate.html" %} 
This will fail silently if the template doesn't exist. 
If it does, it will be rendered with the current context.""" 
TE yis 
tag name, template name - token.split contents() 
except ValueError: 
raise template.TemplateSyntaxError, \ 
"%r tag requires a single argument" % Ntoken.contents.split()[0] 
return IncludeNode(template name) 


1. Then, we need the node class in the same file, as follows: 


class IncludeNode(template.Node): 
def amd temsebt tempLatesrame): 
self.template name - template name 


demerenden(isedn context): 
ENY 
# Loading the template and rendering it 
template_name = template.resolve_variable( 
self. template_name, context) 
included template = get_template(template_name).\ 
render (context) 
except template.TemplateDoesNotExist: 
included_template = "" 
return included_template 


The {% try to include %} template tag expects one argument, that is, template name . So, 
inthe try to include function, we are trying to assign the split contents of the token only to 
the tag name variable (which is "try to include" ) and the template name variable. If this 
doesn't work, the template syntax error is raised. The function returns the 1ncludeNode 
object, which gets the template name field for later usage. 


{% try to include %} 模板 标签 需要 一 个 参数 ， 即 ， template name ° AW > EH 
数 try_to_include 中 ， 


In the render method of IncludeNode , we resolve the template name variable. If a context 
variable was passed to the template tag, then its value will be used here for template name . 
If a quoted string was passed to the template tag, then the content within quotes will be used 


for template name 


Lastly, we try to load the template and render it with the current template context. If that 
doesn't work, an empty string is returned. 


There are at least two situations where we could use this template tag: 


When including a template whose path is defined in a model, as follows: 


{% load utility tags %} 
{% try to include object.template path %} 


When including a template whose path is defined with the (96 with %} template tag som 


B e r[ 





#templates/cms/start_page.html 

{% with editorial_content_template_path="cms/plugins/editorial_content/start_page.html" % 
{% placeholder "main_content" %} 

{% endwith %} 


#templates/cms/plugins/editorial_content.html 
{% load utility_tags %} 


{% if editorial_content_template_path %} 
{% try_to_include editorial_content_template_path %} 
{% else %} 


<div> 
<!-- Some default presentation of 
editorial content plugin --> 

</div> 


{% endif %} 





You can use the {% try to include %} tag as well as the default {% include %} tag to 
include templates that extend other templates. This has a beneficial use for large-scale 
portals where you have different kinds of lists in which complex items share the same 
structure as widgets but have a different source of data. 


For example, in the artist list template, you can include the artist item template as follows: 


(96 load utility tags %} 
(96 for object in object list %} 

(96 try to include "artists/includes/artist item.html" 96) 
(96 endfor %} 


This template will extend from the item base as follows: 


{% extends "utils/includes/item_base. html" %} 
{% block item_title %} 


{{ object.first_name }} {{ object.last_name }} 
{% endblock %} 


The item base defines the markup for any item and also includes a Like widget, as follows: 


{# templates/utils/includes/item_base.html #} 
{% load likes_tags %} 


<h3>{% block item_title %}{% endblock %}</h3> 
{% if request.user.is_authenticated %} 

{% like_widget for object %} 
{% endif %} 


参阅 


The Creating templates for Django CMS recipe in Chapter 7, Django CMS 
The Writing your own CMS plugin recipe in Chapter 7, Django CMS 

The Implementing a Like recipe in Chapter 4, Templates and JavaScript 
The Creating a template tag to load a QuerySet in a template recipe 

The Creating a template tag to parse content as a template recipe 

The Creating a template tag to modify request query parameters recipe 


创建 一 个 模板 标签 以 载 入 模板 中 的 Queryset 


Most often, the content that should be shown in a web page will have to be defined in the 
view. If this is the content to show on every page, it is logical to create a context processor. 
Another situation is when you need to show additional content such as the latest news or a 


random quote on some specific pages, for example, the start page or the details page of an 
object. In this case, you can load the necessary content with the {% get objects %} 
template tag, which we will implement in this recipe. 


准备 开始 
Once again, we will start with the utils app that should be installed and ready for custom 


template tags. 


我 们 会 再 一 次 从 安装 好 的 utils 应 用 开始 ， 为 定制 模板 标签 做 好 准备 。 


如 何 做 


Template tags consist of function parsing arguments passed to the tag and a node class that 
renders the output of the tag or modifies the template context. Perform the following steps: 


模板 标签 由 解析 传递 到 标签 的 参数 的 函数 组 成 ， 而 节点 类 会 传递 外 部 的 标签 或 者 修改 模板 上 
下 文 。 要 达成 模板 ， 需 执行 以 下 步骤 : 


1. First, let's create the function parsing the template-tag arguments, as follows: 
首选 ， 让 我 们 来 创建 函数 去 解析 模板 标签 参数 ， 一 如 下 面 内 容 所 示 : 


Django 网 


中 






占 开 发 Cookbook 


#utils/templatetags/utility_tags.py 
# -*- coding: UTF-8 -*- 

from django.db import models 

from django import template 
register = template.Library() 


### TAGS ### 


@register.tag 
def get_objects(parser, token): 


Sa —— SS SSS eer 


Gets a queryset of objects of the model specified by app and 
model names 
Usage: 
{% get objects [<manager>.]<method> from <app_name>.<model_name> [limit <amount>] 
Example: 
{% get_objects latest_published from people.Person limit 3 as people %} 
{% get_objects site_objects.all from news.Article limit 3 as articles %} 
{% get_objects site_objects.all from news.Article as articles %} 
amount = None 
LEIAWE 
tag_name, manager_method, str_from, appmodel, str_limit,\ 
amount, str as, var name = token.split contents() 
except ValueError: 
Eny: 
tag name, manager method, str from, appmodel, str_as,\ 
var name - token.split contents() 
except ValueError: 
raise template.TemplateSyntaxError, \ 
"get objects tag requires a following syntax: " 
"(96 get objects [<manager>.]<method> from "\ 
"<app_ name>.<model_name>"\ 
" [limit <amount>] as <var_name> %}" 
(EIS 
app_name, model_name = appmodel.split(".") 
except ValueError: 
raise template.TemplateSyntaxError, \ 
"get objects tag requires application name and "\ 
"model name separated by a dot" 
model - models.get model(app name, model name) 
return ObjectsNode(model, manager method, amount, var name) 





1. 如 下 ， 接 着 在 同样 的 文件 中 创建 节点 类 : 





class ObjectsNode(template.Node): 
def _ init (self, model, manager method, amount, var name): 
self.model - model 
self.manager method - manager method 
self.amount - amount 
self.var name - var name 


def render(self, context): 
if "." in self.manager method: 
manager, method - self.manager method.split(".") 
else: 
manager - " default manager" 
method = self.manager method 


qs - getattr( qs - getattr( 
getattr(self.model, manager), 
method, 
self.model. default manager.none, 
)() 
if self.amount: 
amount = template.resolve variable(self.amount, 


context) 
context[self.var name] - qs[:amount] 
else: 
context[self.var name] - qs 
return " 


工作 原理 


The {% get objects %} template tag loads a Queryset defined by the manager method 
from a specified app and model, limits the result to the specified amount, and saves the 
result to a context variable. 


This is the simplest example of how to use the template tag that we have just created. It will 
load five news articles in any template using the following snippet: 


(96 load utility tags %} 
(96 get objects all from news.Article limit 5 as latest articles %} 
(96 for article in latest articles %} 

«a href="{{ article.get url path }}">{{ article.title }}</a> 
(96 endfor %} 


This is using the all method of the default objects manager of the Article model, and will 
sort the articles by the ordering attribute defined inthe meta class. 


Amore advanced example would be required to create a custom manager with a custom 
method to query objects from the database. A manager is an interface that provides 
database query operations to models. Each model has at least one manager called 
objects by default. As an example, let's create the artist model, whichhasa draft or 
published status, and anew manager, custom_manager , which allows you to select random 
published artists: 
更 高 级 的 一 个 例子 是 ， 按 要 求 使 用 定制 方法 查询 数据 库 对 象 以 创建 一 个 定制 的 管理 器 。 


wu 


理 


器 是 一 个 提供 对 模型 进行 数据 库 查询 操作 的 接口 。 例 如 ， 我 们 创建 Artist ps ， 它 含有 一 
个 draft 或 者 published 状态 ， 新 的 管理 器 custom | manager. 允许 你 随机 地 选择 一 位 艺术 工作 





F s coding: Fi TF 
Don django.db Tue models 
from django.utils.translation import ugettext lazy as . 


STATUS CHOICES - ( 
(vdraft (CDraf ta), 
('published', ("Published"), 
) 
class ArtistManager (models.Manager): 
def random published(self): 
return self.filter(status-"published").order by('?') 








class Artist(models.Model): 


status = models.CharField( ("Status"), max length-20, choices-STATUS CHOICES) 
custom manager = ArtistManager() 


To load a random published artist, you add the following snippet to any template: 


{% load utility tags %} 
{% get objects custom manager.random published from artists.Artist limit 1 as random arti 
(96 for artist in random artists %} 
{{ artist.first name }} {{ artist.last name }} 
(96 endfor %} 





Let's look at the code of the template tag. In the parsing function, there is one of two formats 
expected: with the limit and without it. The string is parsed, the model is recognized, and 
then the components of the template tag are passed to the objectNode class. 


让 我 来 看 看 那 模板 标签 的 代码 。 在 解析 函数 中 ， 有 两 种 格式 的 一 种 是 需要 的 : 有 限制 的 ， 或 
者 干脆 就 没有 。 只 要 字符 串 被 解析 出 来 ， 模 型 就 会 识别 它 ， 然 后 模板 标签 的 组 件 被 传递 


到 objectNode 类 。 


In the render method of the node class, we check the managers name and its method's 

name. If this is not defined，_default_manager will be used, which is, in most cases, the 

same as objects. After that, we call the manager method and fall back to empty QuerySet if 

the method doesn't exist. If the limit is defined, we resolve the value of it and limit the 
QuerySet . Lastly, we save the QuerySet to the context variable. 


参阅 
The Creating a template tag to include a template if it exists recipe 
The Creating a template tag to parse content as a template recipe 
The Creating a template tag to modify request query parameters recipe 


创建 模板 标签 并 将 内 容 解析 为 模板 


In this recipe, we will create a template tag named {% parse 96), which allows you to put 
template snippets into the database. This is valuable when you want to provide different 
content for authenticated and non-authenticated users, when you want to include a 
personalized salutation, or when you don't want to hardcode media paths in the database. 


准备 开始 
No surprise, we will start with the utils app that should be installed and ready for custom 


template tags. 


你 不 必 如 此 证 异 ， 我 们 依旧 从 安装 好 的 utils 应 用 开始 ， 并 为 定制 模板 标签 做 好 准备 。 


工作 原理 


Template tags consist of two things: the function parsing the arguments of the template tag 
and the node class that is responsible for the logic of the template tag as well as for the 
output. Perform the following steps: 


1. First, let's create the function parsing the template-tag arguments, as follows: 


#utils/templatetags/utility_tags.py 
# -*- coding: UTF-8 -*- 

from django import template 
register = template.Library() 


### TAGS ### 


@register.tag 
def parse(parser, token): 
Parses the value as a template and prints it or saves toa 
variable 
Usage: 
{% parse <template_value> [as <variable>] %} 
Examples: 
{% parse object.description %} 
{% parse header as header %} 
{% parse "{{ MEDIA_URL }}js/" as js_url %} 
bits = token.split_contents() 
tag_name = bits.pop(0) 
EON: 
template value = bits.pop(9) 
var name = None 
if len(bits) -- 2: 
bits.pop(O) # remove the word "as" 
var name = bits.pop(0) 
except ValueError: 
raise template.TemplateSyntaxError, \ 
"parse tag requires a following syntax: "\ 
"{% parse «template value» [as <variable>] %}" 


return ParseNode(template value, var name) 


1. Then, we create the node class in the same file, as follows: 


class ParseNode(template.Node): 
def | init (self, template value, var name): 
self.template value - template value 
self.var name - var name 


def render(self, context): 
template value - template.resolve variable( 
self.template value, context) 
t - template.Template(template value) 
context vars = {} 
for d in list(context): 
for var, val in d.items(): 
context vars[var] - val 
result - t.render(template.RequestContext( 
context['request'], context vars)) 
if self.var name: 
context[self.var name] - result 
return "" 
return result 


工作 原理 


The {% parse %} template tag allows you to parse a value as a template and to render it 
immediately or to save it as a context variable. 


If we have an object with a description field, which can contain template variables or logic, 
then we can parse it and render it using the following code: 


(96 load utility tags %} 
{% parse object.description %} 
It is also possible to define a value to parse using a quoted string like this: 


(96 load utility tags %} 
(96 parse "{{ STATIC URL }}site/img/" as img path %} 
<img src="{{ img path }}someimage.png" alt="" /> 


Let's have a look at the code of the template tag. The parsing function checks the arguments 
of the template tag bit by bit. At first, we expect the name parse, then the template value, 
then optionally the word as, and lastly the context variable name. The template value and 
the variable name are passed to the ParseNode class. The render method of that class at 
first resolves the value of the template variable and creates a template object out of it. Then, 
it renders the template with all the context variables. If the variable name is defined, the 
result is saved to it; otherwise, the result is shown immediately. 


参阅 


The Creating a template tag to include a template if it exists recipe 
The Creating a template tag to load a QuerySet in a template recipe 
The Creating a template tag to modify request query parameters recipe 


创建 一 个 模板 标签 以 修改 request 查 询 参 数 


Django has a convenient and flexible system to create canonical, clean URLs just by adding 
regular expression rules in the URL configuration files. But there is a lack of built-in 
mechanisms to manage query parameters. Views such as search or filterable object lists 
need to accept query parameters to drill down through filtered results using another 
parameter or to go to another page. In this recipe, we will create a template tag named 

{% append to query %} , which lets you add, change, or remove parameters of the current 


query. 


准备 开始 
Once again, we start with the utils app that should be set in INSTALLED APPS and should 
contain the templatetags package. 


Also, make sure that you have the request context processor set for the 
TEMPLATE CONTEXT PROCESSORS setting, as follows: 


#settings.py 

TEMPLATE_CONTEXT_PROCESSORS = ( 
"django.contrib.auth.context_processors.auth", 
"django.core.context_processors.debug", 
"django.core.context_processors.ii8n", 
"django.core.context_processors.media", 
"django.core.context_processors.static", 
"django.core.context_processors.tz", 
"django.contrib.messages.context_processors.messages", 
"django.core.context_processors.request", 


如 何 做 


For this template tag, we will be using the simple tag decorator that parses the components 
and requires you to define just the rendering function, as follows: 


Zutils/templatetags/utility tags.py 

# -*- coding: UTF-8 -*- 

import urllib 

from django import template 

from django.utils.encoding import force str 
register - template.Library() 


### TAGS ### 


@register.simple_tag(takes_context=True) 
def append_to_query(context, **kwargs): 
""" Renders a link with modified current query parameters """ 
query params = context['request'].GET.copy() 
for key, value in kwargs.items(): 
query params[key] = value 
query string = u"" 
if len(query params): 
query string += u"?%s" % urllib.urlencode([ 
(key, force str(value)) for (key, value) in 
query params. iteritems() if value 


For this template tag, we will be using the simple tag decorator that parses the components 
and requires you to define just the rendering function, as follows: 






tility tags.py 
t codi ng: 
port urllib 
from django import template 

from django.utils.encoding import force_str 
register = template.Library() 


Qregister. simple. tag(takes context-True) 
def append to query(context, **kwargs): 
AU Renders a link with modified current query parameters """ 
query params = context['request'].GET.copy() 
for key, value in kwargs.items(): 
query params[key] - value 
query string = u"" 
if len(query params): 
query string += u"?%s" % urllib.urlencode([ 
(key, force str(value)) for (key, value) in 
query params. iteritems() if value 
]).replace('&', '&amp;') 
return query string 





工作 原理 


The {% append to query %} template tag reads the current query parameters from the 

request.cET dictionary-like QueryDict object to a new dictionary named query params, and 
loops through the keyword parameters passed to the template tag updating the values. 
Then, the new query string is formed, all spaces and special characters are URL-encoded, 
and ampersands connecting query parameters are escaped. This new query string is 
returned to the template. 


To read more about QueryDict objects, refer to the official Django documentation: 
https://docs.djangoproject.com/en/1.6/ref/request-response/#querydict-objects 


Let's have a look at an example of how the {% append_to_query %} template tag can be 
used. If the current URL is http://127.0.0.1:8000/artists/?category=fine-art&page=1 , We 
can use the following template tag to render a link that goes to the next page: 


(96 load utility tags %} 
«a href="{% append to query page-2 %}">2</a> 


The following is the output rendered, using the preceding template tag: 


«a href="?category=fine-art&amp; page=2">2</a> 


Or we can use the following template tag to render a link that resets pagination and goes to 
another category: 


(96 load utility tags i18n %} 
«a href="{% append to query category="Sculpture" page="" %}">{% trans "Sculpture" %}</a> 


E _ — RE] 





The following is the output rendered, using the preceding template tag: 


«a href="?category=sculpture">Sculpture</a> 


The Filtering object lists recipe in Chapter 3, Forms and Views 

The Creating a template tag to include a template if it exists recipe 
The Creating a template tag to load a QuerySet in a template recipe 
The Creating a template tag to parse content as a template recipe 


第 六 章 一 模型 管理 


本 章 我 们 禾 盖 以 下 议题 : 


Customizing columns in the change list page 
Creating admin actions 

Developing change list filters 

Exchanging administration settings for external apps 
Inserting a map into a change form 


引言 


The Django framework comes with a built-in administration system for your models. With 
very little effort, you can set up filterable, searchable, and sortable lists for browsing your 
models, and configure forms for adding and editing data. In this chapter, we will go through 
advanced techniques to customize administration by developing some practical cases. 


Django 框 架 为 你 的 模型 提供 了 一 个 内 建 的 管理 系统 。 只 需 少 许 努力 你 就 可 以 为 模型 浏览 配置 
一 个 可 过 滤 的， 可 搜索 的 ， 可 排序 的 列表 ， 以 及 配置 可 以 添加 和 编辑 数据 的 表单 。 在 这 一 
章 ， 我 们 会 通过 编写 一 个 实际 的 例子 来 彻底 了 解 定制 管理 所 需 的 高 级 技术 © 


定制 切换 列表 页 面 的 中 的 列 


Change list views in the default Django administration system let you have an overview of all 
instances of specific models. By default, the model admin property, list display , controls 
which fields to show in different columns. But additionally, you can have custom functions 
set there that return data from relations or display custom HTML. In this recipe, we will 
create a special function for the 1ist display property that shows an image in one of the 
columns of the list view. As a bonus, we will make one field editable directly in the list view 
by adding the 1ist editable setting. 


改变 默认 的 Djiango 管 理 系 统 中 的 列表 试图 能 够 让 你 拥有 一 个 特定 模型 的 全 部 实例 的 概览 。 默 
认 ， 模 型 admin 的 特性 list display 控制 着 在 不 同 的 列 中 哪 一 个 字段 会 被 显示 。 此 外 ， 你 可 
以 定制 函数 


开始 前 的 准备 


To start with, make sure that django.contrib.admin is in iNsrALLED APPS in the settings, and 
AdminSite is hooked into the URL configuration. Then, create a new app named products 
and put it under iNsrALLED APPS . This app will have the Product and ProductPhoto models, 
where one product might have multiple photos. For this example, we will also be using 
UrlMixin, which was defined in the Creating a model mixin with URL-related methods recipe 
in Chapter 2, Database Structure. 


要 准备 开始 的 话 ， 请 确保 django.contrib.admin 在 设置 文件 的 rNsTALLED APPS T > m E Admin 
站 点 已 经 挂 在 URL 配 置 中 了 。 然 后 创建 一 个 新 的 名 称 为 products 的 应 用 并 把 它 放 

到 INSTALLED_APPS 中 去 。 该 应 用 拥有 模型 prodcut 和 ProdcutPhoto ， 这 里 一 个 procut 可 能 拥 
有 多 张 照片 。 就 我 们 的 这 个 例子 而 言 ， 我 们 也 会 用 到 UrlMixin ， 


Let's create the Product and ProductPhoto models in the models.py file as follows: 


如 下 ， 我 们 在 models.py 文 件 中 模型 Prodcut 和 ProdcutPhoto : 


4products/models.py 

4 -*- coding: UTF-8 -*- 

import os 

from django.db import models 

from django.utils.timezone import now as timezone now 
from django.utils.translation import ugettext lazy as . 
from django.core.urlresolvers import reverse 

from django.core.urlresolvers import NoReverseMatch 
from utils.models import UrlMixin 


def upload to(instance, filename): 
now = timezone now() 
filename base, filename ext - os.path.splitext(filename) 
return "products/%s/%s%S" 96 ( 
instance.product.slug, 
now. strftime("%Y%m%d%H%M%S" ) , 
filename ext.lower(), 


) 


class Product(UrlMixin): 
title = models.CharField( ("title"), max length-26060) 
slug = models.SlugField( ("slug"), max length-26060) 
description = models.TextField( ("description"), blank=True) 
price = models.DecimalField( (u"price (€)"), max digits-$, 
decimal places-2, blank=True, null=True) 


class Meta: 
verbose name - ("Product") 
verbose name plural - ("Products") 


def unicode (self): 
return self.title 


def get url path(self): 
try: 
return reverse("product detail", kwargs={ 
"slug": self.slug}) 
except NoReverseMatch: 
return "^" 


class ProductPhoto(models.Model): 
product - models.ForeignKey(Product) 
photo - models.ImageField( ("photo"), upload to-upload to) 
class Meta: 
verbose name - ("Photo") 
verbose name plural - ("Photos") 


def unicode (self): 
return self.photo.name 


具体 做 法 
We will create a simple administration for the Product model that will have instances of the 


ProductPhoto model attached to the product as inlines. 


In the 1ist display property, we will define the get photo method name of the model 
admin that will be used to show the first photo from the many-to-one relationship. 


Let's create an admin.py file with the following content: 


#products/admin. py 

coding: UTF-8 

from django.db import models 

from django.contrib import admin 

from django.utils.translation import ugettext_lazy as _ 
from django.http import HttpResponse 


from products.models import Product, ProductPhoto 
class ProductPhotoInline(admin.StackedInline): 


model = ProductPhoto 
extra 0 


class ProductAdmin(admin.ModelAdmin) : 
list_display = ["title", "get_photo", "price"] 
list_editable = ["price"] 


fieldsets = ( 
全 人 位 Broduce t 
EestienesUw eseriptrion ee orice 


}), 
) 


prepopulated fields = {"slug": ("title",)} 
inlines = [ProductPhotoInline] 


def get photo(self, obj): 
project photos - obj.productphoto set.all()[:1] 
if project photos.count() » 0: 
return u"""«a href="%(product_url)s" target="_blank"> 
«img src="%(photo_url)s" alt="" width-"100" /> 
fia UNO % { 
"product url": obj.get_url_path(), 
"photo url": project photos[9].photo.url, 


j 


return u"" 


get photo.short description - ("First photo") 
get photo.allow tags = True 


admin.site.register(Product, ProductAdmin) 


工作 原理 


If you look at the product administration list in the browser, it will look like this: 
图 片 : 略 


Besides the normal field names, the 1ist display property accepts a function or another 
callable, the name of an attribute of the admin model, or the name of the attribute of the 
model. Each callable will be passed a model instance as the first argument. So, in our 
example, we have the get photo method of the model admin that retrieves Product as obj. 
The method tries to get the first ProductPhoto from the many-to-one relation and, if it exists, 
it returns HTML with the tag linked to the detail page of Product. 


The short description property of the callable defines the title shown for the column. The 
allow tags property tells the administration not to escape the HTML values. 


In addition, the price field is made editable by the 1ist editable setting and there is a save 
button at the bottom to save the whole list of products. 


e The Creating a model mixin with URL-related methods recipe in Chapter 2, Database 
Structure 

e The Creating admin actions recipe 

e The Developing change list filters recipe 


添加 Admin 的 行为 


The Django administration system provides actions that we can execute for selected items in 
the list. There is one action given by default, and it is used to delete selected instances. In 
this recipe, we will create an additional action for the list of the Product model that allows 
administrators to export selected products to Excel spreadsheets. 


开始 前 的 准备 


我 们 就 从 之 前 方法 中 所 创建 的 应 用 products 开始 。 


具体 做 法 


Admin actions are functions that take three arguments: the current ModelAdmin value, the 
current HttpRequest value, and the QuerySet value containing the selected items. Perform 
the following steps: 


Let's create an export xls function in the admin.py file of the products app, as follows: 


#products/admin. py 

# -*- coding: UTF-8 -*- 
import xlwt 

# ... other imports 


def export_xls(modeladmin, request, queryset): 
response = HttpResponse(mimetype="application/ms-excel") 
response["Content-Disposition"] = "attachment; "\ 
"filename-products.xls" 
xlwt .Workbook(encoding="utf-8") 
wb.add sheet("Products") 


wb 
ws 


row_num = 0 
### Print Title Row ### 
columns = [ 
# column name, column width 
(u"ID", 2000), 
(u"Title", 6000), 
(u"Description", 8000), 
(ulPraice (€)=, 3000); 
] 


header style = xlwt.XFStyle() 
header style.font.bold - True 


for col num in xrange(len(columns)): 
ws.write(row num, col num, columns[col num][9], 
header style) 
# set column width 
ws.col(col num).width = columns[col_num] [1] 


### Print Content ### 


text style = xlwt.XFStyle() 
text style.alignment.wrap = 1 


price style - xlwt.XFStyle() 
price style.num format str - "0.00" 


styles - [text style, text style, text style, price style] 
for obj in queryset.order by("pk"): 
row num += 1 


row = [ 
obj .pk, 
obj.title, 
obj .description, 
obj.price, 

] 


for col num in xrange(len(row)): 
ws.write(row num, col num, row[col num], 
styles[col num]) 


wb.save(response) 
return response 


export xls.short description = u"Export XLS” 


1. Then, add the actions setting to ProductAdmin, as follows: 


class ProductAdmin(admin.ModelAdmin): 
HUE 
actions - [export xls] 


工作 原理 


If you look at the product administration list page in the browser, you will see a new action 
called Export XLS along with the default action Delete selected Products: 


图 片 : 略 


By default, admin actions do something with QuerySet and redirect the administrator back to 
the change list page. However for some more complex actions like this, HttpResponse can 
be returned. The export xls function returns HttpResponse with the MIME type of Excel 
spreadsheet. Using the Content-Disposition header, we set the response to be 
downloadable with the file named products.xls. 


Then, we use the xlwt Python module to create the Excel file. 


At first, the workbook with UTF-8 encoding is created. Then, we add a sheet named 
Products to it. We will be using the write method of the sheet to set the content and style for 
each cell and the col method to retrieve the column and set the width to it. 


To have an overview of all columns in the sheet, we create a list of tuples with column 
names and widths. Excel uses some magical units for the widths of the columns. They are 
1/256 of the width of the zero character for the default font. Next, we define the header style 
to be bold. 


As we have the columns defined, we loop through them and fill the first row with the column 
names, also assigning the bold style to them. 


Then, we create a style for normal cells and for the prices. The text in normal cells will be 
wrapped in multiple lines. Prices will have a special number style with two points after the 
decimal point. 


Lastly, we go through the QuerySet of the selected products ordered by ID and print the 
specified fields into corresponding cells, also applying specific styles. 


The workbook is saved to the file-like HttpResponse object and the resulting Excel sheet 
looks like this: 


表格 : 略 


参阅 
e Chapter 9, Data Import and Export 


e The Customizing columns in the change list page recipe 
e The Developing change list filters recipe 
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本 章 我 们 会 学 习 以 下 内 容 : 


"" Creating templates for Django CMS 
A Django CMS 创建 模板 


Structuring the page menu 
组 织 页 面 菜单 


Converting an app to a CMS app 把 一 个 应 用 转换 到 CMS 应 用 
Attaching your own navigation 加 入 用 户 自己 的 导航 


Writing your own CMS plugin 
编写 用 户 自己 的 CMS 插 件 


Adding new fields to the CMS page 
对 CMS 页 面 添加 新 字段 


本 章 - 我 们 会 学 习 以 下 内 容 : 


e 创建 分 层 类 别 
e 用 django-mptt-admin 生 成 分 类 admin 接 口 
e 用 django-mptt-tree 创 建 分 类 admin 接 口 
。 在 模板 中 传递 分 类 
e 在 表单 中 使 用 一 个 单 
在 表单 中 使 用 一 个 复 


选 字 
选 


本 章 ， 我 们 会 学 习 以 下 技巧 : 


© 从 一 个 本 地 CSV 文 件 导入 数据 
e 从 一 个 本 地 Excel 文件 导入 数据 
© 从 一 个 外 部 JSON 文 件 导 入 数据 
e 从 一 个 外 部 XML 文件 导入 数据 
e 生成 一 个 可 过 滤 的 RSS 订 阅 

e 使 用 Tastypie 为 第 三 方 提供 数据 


在 本 章 ， 我 们 将 学 习 以 下 技巧 : 


。 使 用 Django Shell 

e The monkey patching slugification function 
e The monkey patching model administration 
e Toggling Debug Toolbar 

e Using ThreadLocalMiddleware 

e Caching the method value 

e 通过 电子 邮件 获取 错误 报告 详情 

e 使 用 mod wsgi 在 Apache 上 部 署 项 目 

e 创建 并 使 用 Farbic 部 署 脚本 


En 
wh 


In this chapter, we will go through several other important bits and pieces that will help you 
understand and utilize Django even better. You will get an overview of how to use the 
Django shell to experiment with the code before writing it into files. You will be introduced to 
monkey patching, also known as guerrilla patching, which is a powerful feature of dynamical 
languages such as Python, but should be used with moderation. You will learn how to debug 
your code and check its performance. Lastly, you will be taught how to deploy your Django 
project on a dedicated server. 


使 用 Django shell 


With the virtual environment activated and your project directory selected as the current 
directory, enter this command into your command-line tool: 


(myproject env)$ python manage shell 


By executing the preceding command, you get into an interactive Python shell configured for 
your Django project, where you can play around with the code and inspect classes, try out 
methods, or execute scripts on the fly. In this recipe, we will go through the most important 
functions you need to know to work with the Django shell. 


准备 开始 


Optionally you can install IPython or bpython using one of the following commands, which 
will highlight the syntax for the output of your Django shell: 


(myproject env)$ pip install ipython 
(myproject env)$ pip install bpython 


具体 实现 过 程 


你 可 以 通过 下 面 的 这 些 学 习 到 Django shell 的 使 用 基础 : 


. 输入 下 面 的 命令 以 运行 Django shell : 


(myproject env)$ python manage shell 


The prompt will change to In [1]: or >>> depending on whether you use IPython or not. Now 
you can import classes, functions, or variables and play around with them. For example, to 
see the version of an installed module, you can import the module and then try to read its 
version, VERSION, or version variables: 


>>> import MySQLdb 
>>> MySQLdb. version . 
5152732 


To get a comprehensive description of a module, class, function, method, keyword, or 
documentation topic, use the help function. You can either pass a string with the path to a 
specific entity, or the entity itself, as follows: 


>>> help('django.forms') 


This will open the help page for the django.forms module. Use the arrow keys to scroll the 
page up and down. Press Q to get back to the shell. This is an example of passing an entity 
to the help function. This will open a help page for the ModelForm class: 


>>> from django.forms import ModelForm 
>>> help(ModelForm) 


To quickly see what fields and values are available for a model instance, use the dict 
attribute. Also use the pprint function to get dictionaries printed in a more readable format 
(not just one long line): 


>>> from pprint import pprint 
>>> from django.contrib.contenttypes.models import ContentType 
>>> pprint(ContentType.objects.all()[90]. dict 9) 
{'_state': <django.db.models.base.ModelState object at 0x107560250», 
'app label': u'bulletin board', 
pencils: Meets 
'model': u'bulletin', 
'name': u'Bulletin'} 


Note that by using this method, we don't get many-to-many relationships. But this might be 
enough for a quick overview of the fields and values. 


To get all the available properties and methods of an object, you can use the dir function, as 
follows: 


>>> dir(ContentType()) 








['DoesNotExist', 'MultipleObjectsReturned', ' class ', ' delattr ', ' dict ', ' do 
'sion set', 'pk', 'prepare database save', 'save', 'save base', 'serializable value', 'un 
Ei = 





The Django shell is useful for experimenting with QuerySets or regular expressions before 
putting them into your model methods, views, or management commands. For example, to 
check the e-mail-validation regular expression, you can type this into the Django shell: 


>>> import re 

>>> email pattern = re.compile(r'[^Q]*Q[^Q]*N. [^Q]-* ' ) 
>>> email pattern.match('aidasQbendoraitis.lt') 

« sre.SRE Match object at 0x1075681d0» 


To exit the Django shell, press Ctrl + D or type the following command: 


exit() 


工作 原理 


The difference between a normal Python shell and the Django shell is that when you run the 
Django shell, manage.py sets the DJANGO SETTINGS MODULE environment variable to 
the project's settings path, and then Django gets set up. So, all database queries, templates, 
URL configuration, or anything else are handled within the context of your project. 


参见 
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The monkey patching slugification function 


Monkey patching or guerrilla patching is a piece of code that extends or modifies another 
piece of code at runtime. It is not recommended to use monkey patching often, but 
sometimes it is the only possible way to fix a bug in third-party modules without creating a 
separate branch of the module, or to prepare unit tests for testing without using complex 
database manipulations. In this recipe, you will learn how to exchange the default slugify 


function with the third-party awesome-slugify module, which handles German, Greek, and 
Russian words smarter and also allows custom slugification for other languages. The slugify 
function is used to create a URL-friendly version of the object's title or the uploaded 
filename: it strips the leading and trailing whitespace, converts the text to lowercase, 
removes nonword characters, and converts spaces to hyphens. 


